Skip to content

v1.0.0

Latest

Choose a tag to compare

@github-actions github-actions released this 27 Apr 23:42
· 3 commits to main since this release
65a1d8b

This is a major release that transforms claude-supervisor from a task spawner into a full agent orchestration platform.

Breaking changes

  • tasks.conf is removed. Use the interactive prompt, stdin, or argv instead. Run supervisor migrate to upgrade existing projects.
  • .claude/settings.json (supervisor-owned) is replaced by .claude/settings.local.json. Workspace configuration is now delegated to claude-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 watch tails 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 --yes and 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 layout
  • supervisor 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/ via claude-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.