liney: Instructions file for Codex

Liney Repository Collaboration Guide

交流语言 / Communication Language

始终使用简体中文回复。 无论用户使用何种语言提问,所有面向用户的回复、解释和总结都必须用简体中文。代码、标识符、命令、文件路径以及代码内的注释保持原样(通常为英文),不要翻译。

Always reply in Simplified Chinese. Regardless of the language the user writes in, all user-facing responses, explanations, and summaries must be in Simplified Chinese. Keep code, identifiers, commands, file paths, and in-code comments as-is (usually English); do not translate them.

Project Overview

Liney is a native macOS terminal workspace app built around AppKit + SwiftUI + a vendored Ghostty runtime. The core product experience centers on a multi-repository sidebar, worktree switching, terminal pane and tab layout restoration, diff and overview helper views, and GitHub and update-related features.

The repository now uses an Xcode project as the primary development entry point. The root still contains release scripts, docs, website code, and local build artifacts.

Repository Layout

• Liney/: Main application source root.
• Liney/App/: App assembly and high-level state orchestration. Start with WorkspaceStore.swift, LineyDesktopApplication.swift, and WorkspaceGitHubCoordinator.swift.
• Liney/Domain/: Domain models for workspaces, pane layouts, tabs, and related state.
• Liney/Persistence/: Workspace state, settings persistence, and migrations.
• Liney/Services/Git/: Git repository inspection, worktree discovery, GitHub CLI integration, and metadata watching.
• Liney/Services/Process/: Subprocess execution wrappers.
• Liney/Services/Terminal/: Terminal sessions, Ghostty bridge code, and surface/controller lifecycle management.
• Liney/Services/Updates/: Sparkle update checks and install flow entry points.
• Liney/Support/: Menus, commands, path formatting, external editor support, sleep prevention, and shared UI state.
• Liney/UI/Sidebar/: Left sidebar tree and bridge logic. The key file is WorkspaceSidebarView.swift.
• Liney/UI/Workspace/: Workspace detail views, pane containers, and terminal pane UI.
• Liney/UI/Overview/: Repository overview and desk views plus their view model.
• Liney/UI/Diff/: Diff window state, rendering, and changed-file models.
• Liney/UI/Canvas/: Global canvas-style UI.
• Liney/UI/Sheets/: Sheets for creating worktrees, SSH sessions, agent sessions, settings, and related flows.
• Liney/UI/Components/: Reusable UI components such as the command palette, terminal host, and toolbar icons.
• Liney/Vendor/: Vendored GhosttyKit.xcframework. Do not modify this without explicit need.
• Tests/: Unit tests covering git parsing, pane layout, terminal sessions, Ghostty input support, overview, diff, workspace tabs and settings, and related logic.
• docs/: Maintainer documentation such as testing and terminal architecture notes.
• scripts/: Local build, signing, release, Sparkle, and Homebrew publishing scripts.
• website/: Website source, separate from the macOS app project.
• dist/: Local build artifacts. Usually not edited directly.