Quick Start

# Initialize overstory in your project
cd your-project
ov init

# Install hooks into .claude/settings.local.json
ov hooks install

# Start a coordinator (persistent orchestrator)
ov coordinator start

# Or spawn individual worker agents
ov sling <task-id> --capability builder --name my-builder

# Check agent status
ov status

# Live dashboard for monitoring the fleet
ov dashboard

# Nudge a stalled agent
ov nudge <agent-name>

# Check mail from agents
ov mail check --inject

Commands

Every command supports --json where noted. Global flags: -q/--quiet, --timing. ANSI colors respect NO_COLOR.

Core Workflow

| Command | Description | |---------|-------------| | ov init | Initialize .overstory/ in current project (--yes, --name) | | ov sling <task-id> | Spawn a worker agent (--capability, --name, --spec, --files, --parent, --depth, --skip-scout, --skip-review, --max-agents, --dispatch-max-agents, --skip-task-check, --runtime, --json) | | ov stop <agent-name> | Terminate a running agent (--clean-worktree, --json) | | ov prime | Load context for orchestrator/agent (--agent, --compact) | | ov spec write <task-id> | Write a task specification (--body) |

Coordination

| Command | Description | |-...