fleet-manager — Claude Code skill: keep tabs on your tmux agent fleet
A skill that reads every claude-code pane in tmux, labels what each agent is doing, and sends replies or new instructions back into the pane.
npx skills add harperreed/dotfiles --skill fleet-manager -a claude-codeWhat fleet-manager does
The skill runs a loop. It calls list_panes with no filters, keeps the claude-code panes, and pulls recent context from each one with get_pane_conversation at count 10. Every pane then gets a label: Working, Needs input, Stuck, Idle or Done. The judgement comes from reading the conversation, not the status line.
You get back a compact table: pane number, project name, status, and a five-word note on what the agent is up to. A closing line tells you how many panes are waiting on a human and how many look stuck. From there you pick the move — answer a question with send_to_pane, redirect a stuck agent, hand work to an idle one, or call stop_pane on a finished one.
Say “handle it” or “you decide” and the skill acts on its own. It answers only when the context makes the answer clear, offers stuck agents a different route, and never halts a working agent. The control daemon has to be running and the MCP server registered, otherwise the tools aren't there and the skill points you at control daemon start --background and ~/.claude/settings.json.
What it helps with
- spot which tmux agents are waiting on a reply
- catch an agent looping on the same error
- hand a fresh task to an idle pane
- stop an agent that already finished
- get one table summarising the whole fleet
Example prompts for the agent
- Check on my agents
- What needs attention?
- Send to the tracker pane: switch to local tests instead
How to install fleet-manager
1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill fleet-manager -a claude-code2Manually: put the files in place
~/.claude/skills/fleet-manager/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/fleet-manager/
1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill fleet-manager -a codex2Manually: put the files in place
.agents/skills/fleet-manager/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill fleet-manager -a cursor2Manually: put the files in place
.cursor/skills/fleet-manager/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install harperreed/dotfiles fleet-manager2Manually: put the files in place
.github/skills/fleet-manager/SKILL.md1Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill fleet-manager -a gemini-cli2Platform CLI
gemini skills install https://github.com/harperreed/dotfiles --path .claude/skills-archive/fleet-managerManually: put the files in place
.devin/skills/fleet-manager/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill fleet-manager -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about fleet-manager
How do I install fleet-manager in Claude Code?
Run npx skills add harperreed/dotfiles --skill fleet-manager -a claude-code. The skill lands at ~/.claude/skills/fleet-manager/SKILL.md.
What does fleet-manager do?
It surveys your claude-code panes in tmux, reads the recent messages, and returns a status table for each pane. On your word it replies, redirects or stops an agent.
What does fleet-manager need to work?
The control daemon running and the MCP server registered. Without them the list_panes and send_to_pane tools aren't available.
