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 脚本、编辑器扩展与桌面应用程序的高级用户。

链接

相关

  • 项目
  • 项目
  • 项目
  • 项目