Agent Manager — a TUI for orchestrating stateless AI agents across isolated git worktrees.
Warning: agman is reckless by design. All Claude agents are executed with
--dangerously-skip-permissions, which means agents can read, write, and execute anything on your machine without asking for confirmation. Do not use agman on a machine where unrestricted AI access to the filesystem and shell is unacceptable.
agman gives each AI-driven development task its own git branch, git worktree, and tmux session — a 1:1:1 mapping that keeps tasks fully isolated. Multiple agents can work on different features simultaneously without branch-switching pain or context pollution.
You manage everything from a single TUI dashboard: create tasks, monitor agent progress, give feedback, review PRs, and attach to any task's tmux session — all without leaving the terminal.
Platform: macOS. Linux should work but is untested. Windows is not supported.
All dependencies are required. agman checks for them on startup and will tell you what's missing.
| Dependency | Purpose |
|---|---|
| Rust | Building from source |
git |
Version control |
tmux |
Terminal multiplexer — one session per task |
Claude Code CLI (claude) |
AI agent execution |
nvim |
Editor in tmux sessions |
lazygit |
Git TUI in tmux sessions |
GitHub CLI (gh) |
PR operations |
direnv |
Directory environment manager |
# 1. Clone the repo
git clone <repo-url> && cd agman
# 2. Build and install
./release.sh
# 3. Add to PATH (if not already)
export PATH="$HOME/.agman/bin:$PATH" # add to your shell profile
# 4. Launch
agmanagman stores its config and state in ~/.agman/. On first launch:
- If
~/.agman/config.tomldoesn't exist, agman creates one with defaults - The
repos_dirkey controls where agman looks for git repos (default:~/repos/) - If the repos directory doesn't exist or has no git repos, a directory picker will appear
# ~/.agman/config.toml
repos_dir = "~/repos/"- Task management — create tasks via wizard, track status, give feedback, restart from specific flow steps
- Agent orchestration — YAML-defined flows chain specialized agents (planner, coder, tester, reviewer, etc.) with stop conditions and loop support
- Git worktree isolation — automatic worktree creation/cleanup per task, branch management, rebase workflows
- Tmux integration — dedicated session per task with pre-configured windows (nvim, lazygit, claude, shell, agent)
- GitHub integration — draft PRs, CI monitoring, review tracking, local merge
- Stored commands — pre-packaged workflows: create-pr, review-pr, address-review, monitor-pr, rebase, local-merge
- Vim-style TUI — fully keyboard-driven with preview pane, built-in editors
Rust with ratatui. Integrates with git (worktrees), tmux (sessions), Claude Code CLI (agents), and GitHub CLI (PRs).