penso/arbor
Run agentic coding workflows in a fully native desktop app for Git worktrees, terminals, and diffs.
Arbor – a native desktop environment for AI‑assisted coding
What it is – Arbor is a fully‑native Rust application (desktop GUI, web UI and CLI) that lets you manage multiple Git repositories, worktrees, terminals and long‑running processes while keeping AI coding agents (Claude, Codex, Gemini, Ollama, etc.) tightly integrated. All components talk to a single daemon, so the GUI, the web dashboard and the command‑line tools share the same state.
Core capabilities (as described in the README)
| Area | What Arbor does |
|---|---|
| Repositories & worktrees | List/create/delete worktrees across many repos; create worktrees directly from GitHub/GitLab issues; preview sanitized names; enforce repo‑local branch‑naming rules via arbor.toml; show last activity timestamps; auto‑link issues to branches/PRs. |
| Embedded terminal & processes | Built‑in PTY terminal with true‑color support, multiple tabs per worktree, optional experimental Ghostty engine, persistent daemon‑backed sessions that survive app restarts, managed processes defined in Procfile or arbor.toml (auto‑restart, memory metrics, signal handling). |
| Diffs & PR review | Side‑by‑side diff view with line counts, file‑tree browsing, multi‑tab diffs, PR summary cards, inline comment actions and refresh. |
| AI agent chat | Chat windows for many agents (Claude, Codex, Gemini, Ollama, LM Studio, OpenRouter, any OpenAI‑compatible /v1/chat/completions endpoint). Automatic model discovery, per‑provider selector, streaming responses (SSE/JSONL), session persistence, token‑usage display. |
| Agent visibility | Detects running coding agents, shows working/waiting state with colored dots, updates in real‑time via WebSocket for both desktop and web UI. |
| Remote daemon & MCP | arbor-httpd serves a remote HTTP API and bundled web UI; arbor-cli provides daemon‑backed commands; arbor-mcp is a stdio‑server client for editors/IDE extensions. Supports authenticated remote daemons, SSH/Mosh outposts, multi‑host configs, and optional Symphony orchestration runtime. |
| UI & theming | Three‑pane layout, command palette, resizable panes, 38 shared themes, live theme sync, desktop notifications, branch‑aware window titles. |
Installation
- macOS –
brew install penso/tap/arbor - Linux / Windows – download pre‑built binaries from the GitHub Releases page.
- From source – clone the repo, install Rust nightly
2025‑11‑30, installjust, then runjust run(GUI) orjust run-mcp(MCP server). See the README for platform‑specific setup scripts (just setup-macos,just setup-linux).
Quick start (CLI examples from the README)
# health check
cargo run -p arbor-cli -- health
# list worktrees as JSON
cargo run -p arbor-cli -- worktrees list --json
# list managed processes
cargo run -p arbor-cli -- processes list --json
# list scheduled tasks
cargo run -p arbor-cli -- tasks list --json
Configuration (repo‑local)
Each repository can contain an arbor.toml that defines:
- presets (e.g., a "Review" command that runs
codexwith a prompt file) - processes (name, command, working directory, auto‑start/restart settings)
- scripts for setup/teardown
- branch naming rules
- agent defaults and checkpointing
- notifications (desktop, webhook URLs, event filters)
- scheduled tasks with cron‑like schedules and optional AI‑triggered prompts.
Global user config lives at ~/.config/arbor/config.toml and includes provider definitions, theme choice, and optional embedded terminal engine selection.
Architecture notes
- The daemon (
arbor-httpd) holds the single source of truth and exposes a REST‑like API used by the GUI (arbor-gui), the web UI (arbor-web-ui), the CLI (arbor-cli) and the MCP server (arbor-mcp). - MCP (Message Control Protocol) lets external tools talk to the daemon over stdio, enabling editor extensions.
- Ghostty VT engine is an optional experimental terminal backend that can be enabled with the
ghostty-vt-experimentalfeature flag. - The project is built on GPUI, a GPU‑accelerated UI framework from Zed.
Who might use it?
- Developers who work on many repositories and need a unified UI for worktrees, terminals and AI‑driven code assistance.
- Teams that want a self‑hosted, native alternative to cloud‑only AI coding assistants.
- Power users who prefer a single daemon to coordinate CLI scripts, editor extensions and a desktop app.
Links
- Live docs: https://penso.github.io/arbor/docs/
- Source: https://github.com/penso/arbor
- Release page: https://github.com/penso/arbor/releases
- Similar tools: Superset, Jean, Conductor (mentioned in README).
Related
- Project
- Project
- Project
- Project