Repository navigation
This is a major release that transforms claude-supervisor from a task spawner into a full agent orchestration platform.
Breaking changes
tasks.confis removed. Use the interactive prompt, stdin, or argv instead. Runsupervisor migrateto upgrade existing projects..claude/settings.json(supervisor-owned) is replaced by.claude/settings.local.json. Workspace configuration is now delegated toclaude-workspace-kit.
What's new
Task input — no more config file editing
- Interactive prompt loop: describe tasks one by one, confirm when done
- Stdin mode:
echo "- fix bug [model: haiku]" | supervisor - Argv mode:
supervisor run "task 1" "task 2" supervisor last— respawn the previous session's task list- Bullet grammar with inline tags:
[model:],[plan],[branch:],[depends:]
Task dependencies
[depends: branch-name]stages a task behind another — the dependent agent spawns automatically when its dependency finishes, with the diff summary prepended as context
Live watch dashboard
supervisor watchtails each agent's Claude Code session log and renders a live status table refreshing every 3 seconds- Agents idle for more than 5 minutes are flagged as stuck
Agent lifecycle hooks
- Stop hook fires automatically when an agent finishes, running
collect-learnings.sh --yesand appending a completion record to.claude/supervisor-session-summary.jsonl
Shared peer notes
.claude/agents-shared/is symlinked into every worktree so parallel agents share a common notes directory/share <message>— append a timestamped note visible to all peers/peers— read recent updates from all other agents
New subcommands
supervisor doctor— diagnose project state (hooks, worktrees, tmux session, dependencies)supervisor migrate— guided upgrade from 0.2.x layoutsupervisor uninstall— remove supervisor files (--with-workspace,--everything,--dry-run)supervisor update— refresh workspace-kit and supervisor overlay
Workspace-kit integration
- On first run, supervisor prompts to bootstrap
.claude/viaclaude-workspace-kit - Supervisor writes only its own overlay (
settings.local.json,agents-shared/, CLAUDE.md fenced block) — the two tools never touch each other's files
Upgrade from 0.2.x
supervisor migrate ~/my-project
See the Upgrading from 0.x to 1.0 section in the README for full details and rollback instructions.