How alexeyv/chainsaw works
Chainsaw is a Rust supervisor for continuously coordinating spec-driven coding runs across LLM sessions. A human starts and steers a run; the lead creates and dispatches tasks, implementers produce commits, and the commentator reports observations or findings for the lead to address. The supervisor tracks sessions, prompts, task state, and review data in SQLite while using a terminal runtime and agent-specific transcripts. The README documents the overall roles and loop; sampled source confirms task/review persistence and session abstractions, but not every coordinator dispatch or integration call.
Main entry points: sessions.rs Session coordination · review.rs Review exchange · coordinator.rs Lead coordination · tasks.rs Task lifecycle
Components 21
Run coordination
- Supervisor CLI
skills/chainsaw/coordinator/src/cli.rs - Run daemon
skills/chainsaw/coordinator/src/coordinator/daemon.rs - Lead coordination
skills/chainsaw/coordinator/src/coordinator.rs
Task and review
- Task lifecycle
skills/chainsaw/coordinator/src/coordinator/tasks.rs - Review exchange
skills/chainsaw/coordinator/src/coordinator/review.rs - Git operations
skills/chainsaw/coordinator/src/infra/git.rs - Task calibration
skills/chainsaw/coordinator/src/coordinator/calibrate.rs
Agent sessions
- Session coordination
skills/chainsaw/coordinator/src/coordinator/sessions.rs - Prompt handling
skills/chainsaw/coordinator/src/coordinator/prompt.rs - Agent adapters
skills/chainsaw/coordinator/src/infra/agent.rs - Terminal runtime
skills/chainsaw/coordinator/src/infra/session_runtime.rs - Transcript monitor
skills/chainsaw/coordinator/src/infra/transcript_monitor.rs - Session model
skills/chainsaw/coordinator/src/domain/session.rs
Run state
- Run/task models
skills/chainsaw/coordinator/src/domain/task.rs - SQLite store
skills/chainsaw/coordinator/src/persistence/store.rs - Task records
skills/chainsaw/coordinator/src/persistence/task.rs - Session records
skills/chainsaw/coordinator/src/persistence/session.rs - Review records
skills/chainsaw/coordinator/src/persistence/finding.rs - Observations
skills/chainsaw/coordinator/src/persistence/observation.rs - Prompt records
skills/chainsaw/coordinator/src/persistence/prompt.rs
Other components
- Human
Connections 24
- Human → Supervisor CLI: starts and steers
- Supervisor CLI → Run daemon: runs
- Run daemon → Lead coordination: coordinates run
- Lead coordination → Task lifecycle: creates and dispatches
- Task lifecycle → Task records: reads and writes
skills/chainsaw/coordinator/src/coordinator/tasks.rs - Task lifecycle → Git operations: checks repository
- Lead coordination → Session coordination: hands out work
- Session coordination → Session records: reads and writes
skills/chainsaw/coordinator/src/coordinator/sessions.rs - Session coordination → Terminal runtime: controls sessions
- Session coordination → Transcript monitor: monitors transcripts
skills/chainsaw/coordinator/src/coordinator/sessions.rs - Session coordination → Agent adapters: uses agent adapters
- Agent adapters → Terminal runtime: starts sessions
skills/chainsaw/coordinator/src/infra/agent.rs - Agent adapters → Transcript monitor: reads transcripts
skills/chainsaw/coordinator/src/infra/agent.rs - Session records → Session model: materializes
skills/chainsaw/coordinator/src/persistence/session.rs - Prompt handling → Prompt records: tracks prompts
- Lead coordination → Review exchange: receives findings
- Review exchange → Review records: reads and writes
skills/chainsaw/coordinator/src/coordinator/review.rs - Review exchange → Observations: reads and writes
skills/chainsaw/coordinator/src/coordinator/review.rs - Review exchange → Task records: validates task
skills/chainsaw/coordinator/src/coordinator/review.rs - SQLite store → Task records: hosts records
skills/chainsaw/coordinator/src/persistence/store.rs - SQLite store → Session records: hosts records
skills/chainsaw/coordinator/src/persistence/store.rs - Git operations → Task lifecycle: supports commit checks
- Task calibration → SQLite store: records estimates
- Human → Review exchange: observes and steers