One agent per worktree.

The picker (⌘⇧W)

The worktree picker lists every worktree of the current repo — parsed from git worktree list — labeled by branch, with the primary and locked ones marked. From it you create a worktree (new branch, new directory), open one in a tab, or remove one. Mutations run through the git CLI on a worker thread, and failures surface their actual stderr in the picker footer instead of a generic error.

Worktree environments

A project can declare up and down scripts. worktree up runs each up script in its own pane of a tab dedicated to the worktree — dev server here, watcher there — and worktree downruns the down scripts headless before closing the environment's panes. The worktree itself stays on disk.

# .quorum-term.toml at the repo root (checked in, shared)
[[up]]
name = "web"
command = "npm run dev"
cwd = "marketing-site"

[[up]]
name = "agent"
command = "cargo run"

[[down]]
name = "stop"
command = "docker compose down"

Configuration resolves from two layers: the repo-local .quorum-term.toml (shared with the team) wins section-by-section over a [[projects]]entry in the global config (per-machine). Environment tabs show a marker glyph and the branch's CI verdict from the last GitHub status fetch.

From the CLI

quorum-term worktree            # open the picker overlay
quorum-term worktree up         # env up for the focused pane's worktree
quorum-term worktree up ~/w/x   # env up for a specific worktree
quorum-term worktree down       # run down scripts, close the env panes