0 Fork 0

mirror of https://github.com/PR0M3TH3AN/SeedPass.git synced 2026-10-27 16:02:05 +00:00

Files

T

thePR0M3TH3ANandClaude Opus 4.6 ca31abf33e Fix Overstory multi-agent setup and add quick reference docs

- Update agent models from gpt-5.3-codex to claude-compatible names
  (opus for coordinator/lead, sonnet for builder/scout/reviewer/merger,
  haiku for monitor)
- Switch runtime from codex to claude (codex requires interactive TTY,
  incompatible with tmux-based agent spawning)
- Add Overstory ecosystem links to AGENTS.md and CLAUDE.md
- Add docs/overstory_quick_reference.md with startup, monitoring, and
  CLI commands
- Sync seeds issue state

Co-Authored-By: Claude Opus 4.6 <[email protected]>

2026-03-06 13:12:46 -05:00

3.1 KiB

Raw Blame History

Overstory Quick Reference

Prerequisites

Start a tmux server before launching any agents:

tmux new-session -d -s base

Starting the Coordinator

ov coordinator start

This spawns the coordinator agent in a tmux session. It runs at the project root and orchestrates all other agents (leads, builders, scouts, reviewers, mergers).

Attach to the Coordinator Session

tmux attach -t overstory-SeedPass-coordinator

Detach without stopping: Ctrl+b then d

Stop the Coordinator

ov coordinator stop

Monitoring

Status (snapshot)

ov status

Shows all active agents, their states, worktrees, and PIDs.

Dashboard (live TUI)

ov dashboard

Live-updating view of all agents. Ctrl+C to exit.

Coordinator Status

ov coordinator status

Shows coordinator-specific info: session ID, PID, uptime, watchdog/monitor state.

Event Feed (real-time log stream)

ov feed

Unified real-time event stream across all agents.

Agent Inspection

ov inspect <agent-name>    # Deep inspection of a single agent
ov logs                     # Query logs across agents
ov trace <agent-or-task>    # Chronological event timeline
ov errors                   # Aggregated error view
ov replay                   # Interleaved chronological replay

Health Check

ov doctor

Runs diagnostics on the Overstory setup: config, databases, agents, dependencies, consistency.

Cleanup

ov clean --sessions       # Wipe sessions.db
ov clean --worktrees      # Remove worktrees + kill tmux sessions
ov clean --agents         # Remove agent identity files
ov clean --all            # Nuclear: wipe everything

Mail System

ov mail check                           # Check for unread messages
ov mail list [--from <agent>] [--unread] # List messages
ov mail read <id>                        # Read a message
ov mail send --to <agent> --subject "..." --body "..." --type dispatch

Costs & Metrics

ov costs       # Token/cost analysis
ov metrics     # Session metrics

Configuration

Config file: .overstory/config.yaml

Key settings:

runtime.default: claude — CLI runtime (options: claude, codex, pi, copilot, gemini). Note: codex does not work with tmux.
agents.maxConcurrent: 25 — max simultaneous agents
agents.maxDepth: 2 — hierarchy depth limit
project.canonicalBranch: beta — branch agents merge into

Agent definitions: .overstory/agent-defs/ Agent manifest: .overstory/agent-manifest.json

Ecosystem Tools

Tool	CLI	Purpose
Overstory	`ov`	Multi-agent coordinator
Mulch	`mulch` / `ml`	Agent expertise/memory
Canopy	`cn`	Prompt management
Seeds	`sd`	Git-native issue tracking
os-eco	—	Ecosystem meta-repo

Updating Tools

bun update -g @os-eco/overstory-cli @os-eco/mulch-cli @os-eco/canopy-cli @os-eco/seeds-cli

3.1 KiB Raw Blame History