penso/arbor
Run agentic coding workflows in a fully native desktop app for Git worktrees, terminals, and diffs.
Arbor – 用于 AI 辅助编码的原生桌面环境
简介 – Arbor 是一个完全原生的 Rust 应用程序(包含桌面 GUI、网页 UI 与 CLI),让您可以管理多个 Git 仓库、工作树、终端与长时间运行的进程,同时将 AI 编码代理(Claude、Codex、Gemini、Ollama 等)紧密集成。所有组件皆与单一守护进程通信,因此 GUI、网页仪表板与命令行工具共享相同的状态。
核心功能(如 README 所述)
| 项目 | Arbor 的功能 |
|---|---|
| 仓库与工作树 | 列出/创建/删除跨多个仓库的工作树;直接从 GitHub/GitLab 问题创建工作树;预览清理后的名称;通过 arbor.toml 强制执行仓库本地的分支命名规则;显示最后活动时间戳;自动将问题链接至分支/PR。 |
| 嵌入式终端与进程 | 内置支持真彩色的 PTY 终端、每个工作树多个标签页、可选的实验性 Ghostty 引擎、在应用程序重启后仍能存续的守护进程后端会话、由 Procfile 或 arbor.toml 定义的受管进程(自动重启、内存指标、信号处理)。 |
| 差异与 PR 审查 | 并排差异视图(含行数统计)、文件树浏览、多标签差异、PR 摘要卡片、内嵌评论操作与刷新。 |
| AI 代理对话 | 适用于多种代理的对话窗口(Claude、Codex、Gemini、Ollama、LM Studio、OpenRouter、任何兼容 OpenAI 的 /v1/chat/completions 端点)。自动模型发现、各提供商选择器、流式响应(SSE/JSONL)、会话持久化、Token 使用量显示。 |
| 代理可见性 | 检测运行中的编码代理,以彩色圆点显示工作/等待状态,并透过 WebSocket 实时更新桌面与网页 UI。 |
| 远程守护进程与 MCP | arbor-httpd 提供远程 HTTP API 与捆绑的网页 UI;arbor-cli 提供由守护进程支持的命令;arbor-mcp 是供编辑器/IDE 扩展使用的 stdio 服务器客户端。支持已验证的远程守护进程、SSH/Mosh 前哨站、多主机配置以及选用的 Symphony 编排运行时。 |
| UI 与主题 | 三窗格布局、命令面板、可调整大小的窗格、38 种共享主题、实时主题同步、桌面通知、感知分支的窗口标题。 |
安装
- macOS –
brew install penso/tap/arbor - Linux / Windows – 从 GitHub Releases 页面下载预编译的二进制文件。
- 从源代码安装 – 克隆仓库,安装 Rust nightly
2025‑11‑30,安装just,然后运行just run(GUI) 或just run-mcp(MCP 服务器)。请参阅 README 以获取特定平台的设置脚本(just setup-macos,just setup-linux)。
快速入门(来自 README 的 CLI 示例)
# 健康检查
cargo run -p arbor-cli -- health
# 以 JSON 格式列出工作树
cargo run -p arbor-cli -- worktrees list --json
# 列出受管进程
cargo run -p arbor-cli -- processes list --json
# 列出定时任务
cargo run -p arbor-cli -- tasks list --json
配置(仓库本地)
每个仓库皆可包含一个 arbor.toml,定义:
- 预设设置(例如:运行
codex并搭配提示文件的“审查”命令) - 进程(名称、命令、工作目录、自动启动/重启设置)
- 设置/拆卸脚本
- 分支命名规则
- 代理默认值与检查点
- 通知(桌面、Webhook URL、事件过滤器)
- 定时任务(具备类似 cron 的调度与选用的 AI 触发提示)。
全局用户配置位于 ~/.config/arbor/config.toml,包含提供商定义、主题选择以及选用的嵌入式终端引擎选择。
架构说明
- 守护进程 (
arbor-httpd) 保存单一事实来源,并公开 GUI (arbor-gui)、网页 UI (arbor-web-ui)、CLI (arbor-cli) 与 MCP 服务器 (arbor-mcp) 所使用的 REST 风格 API。 - MCP (Message Control Protocol) 让外部工具能通过 stdio 与守护进程通信,从而启用编辑器扩展。
- Ghostty VT 引擎 是一个可选的实验性终端后端,可通过
ghostty-vt-experimental功能标志启用。 - 本项目建立于 GPUI 之上,这是来自 Zed 的 GPU 加速 UI 框架。
谁适合使用?
- 需要在多个仓库工作,并需要一个统一 UI 来管理工作树、终端与 AI 驱动编码辅助的开发者。
- 希望拥有自托管、原生替代方案,而非仅依赖云端 AI 编码助手的团队。
- 偏好使用单一守护进程来协调 CLI 脚本、编辑器扩展与桌面应用程序的高级用户。
链接
- 实时文档: https://penso.github.io/arbor/docs/
- 源代码: https://github.com/penso/arbor
- 发布页面: https://github.com/penso/arbor/releases
- 类似工具: Superset, Jean, Conductor (README 中提及)。
相关
- 项目
- 项目
- 项目
- 项目