agent-manager

README

Agent Manager

A terminal UI to manage AI coding-agent sessions on your machine. Create and enter sessions, organize them in a nested group tree with manual ordering, archive finished ones, and watch live status, a live pane preview, the combined footprint of your agents, and machine resource gauges.

Supported tools

Status detection currently supports Claude Code and OpenCode out of the box. Any other CLI tool can run as a session; add a [tools.<name>] block with status rules to get live status for it (see Configuration).

Requirements

• Go 1.24+
• tmux

Install

git clone https://github.com/YoanWai/agent-manager.git
cd agent-manager
go install .

Installs agent-manager to $(go env GOPATH)/bin.

Usage

agent-manager

Sessions run inside tmux (am_* namespace), so they survive the manager quitting. Inside a session, Ctrl+Q detaches back to the manager.

Keys

Key	Action
n	New session (name, tool, directory, group picker)
g	New group (name, parent, default path)
enter	Attach session / fold group
ctrl+q	Inside a session: back to the manager
shift+↑ / shift+↓	Reorder session or group among its siblings
m	Move session to another group
r	Rename session or group
a / u	Archive / restore
d	Delete session, or a group + its entire subtree
space	Collapse / expand group
t	Toggle archived view
/	Search
ctrl+r	Force refresh
?	Help
q	Quit (sessions keep running)

Groups

Groups are paths (backend/api/auth) forming a tree of unlimited depth. Sessions can live at any node, including the root. Create subgroups inline with g, and reorder both groups and sessions with shift+↑↓; the order persists.

Status

Each session's tmux pane is polled (default every 2s) to derive a status:

Status	Meaning
working	The agent is busy on a turn
waiting	Blocked on you: a dialog, a permission ask, or a plain-text question
finished	Turn ended — an alert that clears to idle once you enter the session
errored	The tool reported an error
idle	Nothing running
dead	The tmux session is gone

Detection matches per-tool regex rules against the visible pane, analyzes the newest turn to tell finished from waiting, and treats streaming output (content changing between polls) as working. Polling keeps running while you are inside a session, so statuses stay live. The selected session's pane tail renders in the preview panel, and moving the cursor fetches the preview immediately.

Stats

The header shows a fleet summary: per-status session counts and the combined CPU/RAM of every live agent's full process tree. The Computer block in the sessions panel shows machine gauges: CPU, memory (used/total), swap, root-disk free space, and network up/down rates.

Configuration

Config lives in your OS user config dir (~/Library/Application Support/agent-manager/config.toml on macOS, ~/.config/agent-manager/config.toml on Linux) and is created on first run with working defaults for Claude Code and OpenCode.

Add any CLI tool as a [tools.<name>] block:

[tools.mytool]
command = "mytool"
default_status = "idle"
rules = [
  { state = "working", pattern = "esc to interrupt" },
  { state = "errored", pattern = "(?im)^\\s*error:" },
]

Rules match top-down against the visible pane text; first match wins, and default_status applies when nothing matches. Optional per-tool fields refine detection: activity_cutoff (regex locating the tool's input box, everything above it is turn content), turn_end (a turn-summary line marking the turn as over), chrome_line, blocked_line, and trailing_note. The generated config's claude and opencode blocks show all of them in use.

State is stored next to the config in state.db (SQLite).

Development

go test ./...   # includes end-to-end tests against a real tmux server
go run .

License

AGPL-3.0