Questmaster
alexivison/questmaster
Orquestrador de agentes IA em tmux com TUI Bubble Tea
Ver no GitHubCLI e TUI baseado em tmux para orquestração de múltiplos agentes de IA (Claude, Codex, Pi) em sessões coordenadas. Gerencia uma "party" de agentes, promove sessões a master, spawna workers, retransmite mensagens e rastreia atividade via sidebar de terminal.
Instalação
npx convez-ai alexivison/questmaster1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Coordenar múltiplos agentes de codificação em paralelo
- Automatizar workflows complexos de debugging com squads de IA
- Rastrear e gerenciar sessões de agentes independentes
Veredito

Ferramenta especializada e bem-engineered para quem precisa orquestrar múltiplos agentes de IA simultaneamente. Exige familiaridade com tmux, Go e CLIs de agentes; não é para iniciantes, mas resolve um problema real de coordenação.
README
A tradução para o português deste README ainda está na fila.
questmaster
questmaster is a tmux-based orchestration CLI and Bubble Tea TUI for running a small adventuring party of AI coding agents. It starts sessions, promotes a session to master, spawns workers, relays messages, and tracks agent activity from a terminal sidebar.
Prerequisites
- macOS or Linux.
- A Go 1.25.x-capable toolchain. The module declares
go 1.25.7; older Go versions may only work when toolchain auto-download is enabled. tmuxonPATH(brew install tmux,apt install tmux, or your distro package manager).- Install and authenticate at least one agent CLI:
claude,codex,pi, oromp(oh-my-pi). A plainquestmaster startusesclaudeby default, so installclaudefirst or configure/start with another primary. - For non-standard install paths, set
CLAUDE_BIN,CODEX_BIN,PI_BIN, orOMP_BIN; otherwise questmaster checksPATH, then~/.local/bin/claude,/opt/homebrew/bin/codex,/opt/homebrew/bin/pi, or~/.local/bin/omp.
Install
go install github.com/alexivison/questmaster@latest
questmaster version
go install creates the primary questmaster binary only. If you want the optional short alias, create it yourself after installation:
mkdir -p ~/.local/bin
ln -sf "$(go env GOPATH)/bin/questmaster" ~/.local/bin/qm
qm version
From a source checkout:
go build -buildvcs=false -o questmaster .
./questmaster version
Quick start
questmaster start "fix-login-flow"
questmaster start --master --primary codex "release-triage"
questmaster spawn --prompt "Investigate the failing smoke test" "smoke-test-worker"
questmaster spawn --quest QUEST-1 --prompt "Work this quest's tests" "quest-worker"
questmaster relay qm-worker123 "Try a smaller test case."
questmaster report "done: fixed parser edge case; regression test passes"
Inspect state:
questmaster list
questmaster status qm-1234567890
questmaster workers qm-master123
questmaster read qm-worker123
Install or inspect generated agent hooks:
questmaster hooks status
questmaster hooks install --dry-run
questmaster hooks install
Claude and Codex use shell-script hooks merged into their native config; Pi and
omp use an activity-sidecar extension. For omp, questmaster hooks install omp
writes the sidecar to ~/.omp/agent/extensions/ (override the agent dir with
PI_CODING_AGENT_DIR), where omp auto-discovers it on the next launch.
TUI
Running questmaster with no subcommand launches the Bubble Tea tracker TUI. The TUI reads session manifests and hook activity from the questmaster state root, displays active/stale sessions, and provides keyboard-driven status tracking for the current tmux workspace.
Common entry points:
questmaster # launch tracker TUI
questmaster sessions # print session summary
questmaster picker # open interactive session picker
Tracker keys
In the tracker list: j/k (or ↑/↓) move the cursor, Enter attaches to an
active session or continues a stopped one, r relays a message to an active
session, b broadcasts to the current master's workers and s spawns a worker
(both available only when the current session is a master), d deletes, m
inspects the manifest, and q quits. Press c to recolor the selected session's left
gutter on the fly — ←→/h/l cycle the palette (the first entry clears the
color back to inherit/default) with a live preview, Enter applies, Esc
cancels. Recoloring only touches that session; workers spawned earlier keep
their own color.
Creating sessions from the picker
Press n (or m/N for a master) in the picker to open the new-session form. Two shortcuts make this faster:
- Recent directories — on the
Dirfield, pressCtrl-Rto fuzzy-filter the working directories you've already started sessions in (no scanning, no config). Type to narrow,↑/↓to pick,Enter/Tabto use,Escto dismiss. Plain typing andTabpath-completion still work when the browser is closed. - Auto-generated titles — leave
Titleblank and the session is named from your first message: from the initial prompt if you provide one, otherwise from the first message you send once the session is running (the tmux window is renamed to match). An explicit title is always kept as-is.
State
State defaults to ~/.questmaster-state. Override it with QUESTMASTER_STATE_ROOT:
export QUESTMASTER_STATE_ROOT=/path/to/state
Sessions use qm-* IDs (for example qm-1234567890). The current session ID is read from QUESTMASTER_SESSION.
Development
Run the standard checks:
go mod tidy
go build -buildvcs=false ./...
go test ./...
go vet ./...