Meet Agent Marty, Graith’s resident coding-agent pine marten. 🐾
Run a fleet of AI coding agents in parallel — each in its own git worktree, each in a session that outlives your terminal.
graith is a terminal multiplexer built for AI coding agents (Claude, Codex, OpenCode, Cursor, Agy). Spin up an agent per task, let them work isolated and unattended, and jump between them with a tmux-style prefix key. A long-lived daemon owns the sessions, so closing your terminal — or losing your SSH connection — doesn't stop the work.
graith (Scots) — noun: equipment, tools, gear for a specific trade. verb: to make ready, prepare, equip. Your agents, graithed and ready to work.
📖 Documentation — full guide, CLI reference, configuration, and architecture.
Running several agents at once shouldn't mean juggling terminal tabs and stepping on your own branches. graith gives you:
- Isolation — every agent gets its own git worktree and branch, so parallel work never collides
- Persistence — a daemon owns the PTYs; sessions survive terminal closures, daemon restarts, and SSH drops
- Switching — hop between agents instantly with a tmux-style prefix key
- Visibility — see every session at a glance, group the Session Navigator by repository or scenario, and use
gr ls --tokensfor per-session token usage - Coordination — agents message each other over pub/sub, and you drive them remotely with
type,logs, and the Session Navigator
It owns the PTY, manages the worktrees, and otherwise gets out of your way.
With Homebrew:
brew install d0ugal/tap/graithFor apt, dnf, prebuilt binaries, Go, and source installs, see the installation guide. Then follow the getting started guide to create your first session.