Perch
给 coding agent 一个原生的 Mac 工作台。本机与远端任务，都有清楚的工作现场。
English · 简体中文 · 快速开始 · 当前进展
在 Mac 上使用 Kimi 或 Codex，也可以通过 SSH 连接远端 Agent。Perch 将对话、任务、
工具输出与审批放进一个原生工作台：先看结果，需要时展开过程，再决定下一步。
使用 SwiftUI、AppKit 和 Ghostty 构建，保留原生文本编辑、键盘操作，以及 macOS 26
的系统 Liquid Glass 效果。
| 带着上下文开始 | 需要时查看细节 |
|---|---|
| 选好项目、模型与思考强度，权限设置也就在手边。 | 先读结果，再按需展开工具调用和输出。 |
图片为界面渲染示意，使用虚构演示数据，不是原生截图或真实命令执行结果。
浅色外观 · 深色外观 · 进行中的任务 · 素材来源
项目工作台、任务浮窗、文件阅读、统一搜索、交付验收和长任务托管已加入源码预览。使用范围和后台运行条件见工作台说明。
为什么用 Perch
- 原生对话：流式回复、Markdown、思考和工具结果，需要时再展开详情。
- 清楚开始任务：选择本机或远端环境，搜索最近项目，在发送前选好模型、思考强度和权限。
- 任务工作台：会话归组、置顶、归档，重新打开后回到工作现场。
- 集中处理：看到哪些任务在运行、哪些在等你、哪些结果还没读，以及 Kimi 的子 Agent（含其自身过程）与后台任务状态和输出尾部。
- 保留 CLI 工作流：已适配的 Agent 使用原生对话，其他 CLI 通过 Herdr 使用 Ghostty 终端。
- 查看工作内容：在对话旁查看远程文件与只读 Git diff（实验性）。
- 远端执行，本地掌控：文件与工具操作在服务器执行，关闭 Mac App 不会结束托管中的远端会话。
- 明确的权限模式：可按 Agent 设置默认值并在新建任务时覆盖，高风险模式需要再次确认；Kimi、Qoder 与 Claude Code 可从后续消息或轮次调整，OMP 与 Codex 在创建会话时固定。
接入方式
| Agent / 工作流 | 连接方式 | 界面 |
|---|---|---|
| Kimi Code | Kimi Web API + SSH | 原生对话 |
| Oh My Pi（OMP） | 远端桥接 RPC | 原生对话 |
| Qoder CN | 远端桥接官方 Agent SDK | 原生对话 |
| Qoder | 远端桥接官方 Agent SDK | 原生对话 |
| Claude Code | 远端桥接官方 Agent SDK | 原生对话 |
| DeepSeek Harness（dsh） | 远端桥接 ACP | 原生对话 |
| Codex | 远端桥接 codex app-server stdio JSON-RPC |
原生对话 |
| 其他 CLI Agent | Herdr + SSH | 终端 |
原生接入共用对话组件。欢迎扩展 RPC、SDK 或 ACP 适配器；目前不宣称任意协议即插即用。
已验证版本与恢复边界见 Kimi、OMP / Qoder CN / Qoder / dsh / Codex / Claude Code。
凭据和模型由对应 CLI 配置，Perch 不直连模型服务商。
本机已接通 Kimi 与 Codex，其他 Agent 仍仅支持发现；见本机 Agent。Kimi、远端 OMP 与 Codex 支持运行中即时引导，
也可显式选择下一轮发送。Codex 沿用原生 thread ID 和历史，模型与思考强度来自 model/list；
app-server 发起的每个审批与提问都会显示并等待明确回答，不会自动允许或静默拒绝。Qoder CN / Qoder / dsh /
Claude Code 支持停止与下一轮消息排队；Herdr 中的现有会话继续使用终端。
下载
从 Releases 下载 zip 安装包。应用为 ad-hoc
签名（未经 Apple 公证）：首次打开请右键 → 打开。
构建运行
需要 macOS 26+，以及包含 macOS 26 SDK 的 Swift 工具链（Xcode 26 或更新版本）。
当前构建在 Apple Silicon 上验证。远程会话需要可连接的 SSH 主机及对应 Agent。
./scripts/build.sh
open build/Perch.app
本机使用先看 Kimi / Codex 接入说明。
远端使用从首页「连接远程机器」或「环境 → ＋」进入向导：验证 SSH、检查所选 Agent、
按提示安装或登录，再浏览远端目录并开始首个任务。Kimi 端口与令牌文件路径可在
「高级设置」中修改。首次启动没有预设机器。详见快速开始。
⌘N 新建对话 · ⌘K 搜索 · Return 发送 · Shift Return 换行
界面默认跟随系统语言，可在「设置 → 语言」中切换简体中文 / English；侧边栏及其
入口已完整双语，其余区域在翻译补齐前可能仍是中英文混排。
当前进展
源码早期预览，尚非稳定版，长会话响应与恢复能力仍在打磨。远程文件查看与只读 Git diff
处于实验阶段，不同 Agent 的能力有差异，请先阅读对应接入文档。
当前构建使用本地 ad-hoc 签名，暂未提供公证后的安装包。
参与贡献
欢迎问题反馈、小范围修复和新的 Agent 适配器，参见 CONTRIBUTING.md。
截图和问题示例请使用演示会话，去除凭据、个人路径和内部信息。
许可证
MIT。第三方组件保留各自许可证，详见 THIRD_PARTY.md。
