motiful Booth
Booth is an AI project manager for Claude Code. It runs a daemon that dispatches tasks to parallel CC sessions (called "decks"), monitors their progress via JSONL events, and coordinates results through a managing CC session (the "DJ").
Signals
Booth injects signals into CC sessions via the editor proxy (Ctrl+G mechanism):
| Signal | Target | Meaning |
|---|---|---|
/booth-check |
Deck | Self-verify your work and write a report |
/booth-alert |
DJ | A deck needs attention (check complete, deck exited) |
/booth-beat |
DJ | Periodic patrol — review deck states |
Deck Modes
| Mode | Behavior |
|---|---|
| Auto (default) | Complete → check → report → notify DJ → auto-kill |
| Hold | Complete → check → report → pause (waits for next instruction) |
| Live | No auto-check — human drives the session |
Report Statuses
Decks submit reports via booth report CLI → daemon → SQLite:
| Status | Meaning |
|---|---|
SUCCESS |
Task completed, acceptance criteria met |
FAIL |
Task attempted, could not meet criteria |
ERROR |
Unexpected error during execution |
EXIT |
CC session ended (user /exit or crash) |
Key Paths
| Path | Purpose |
|---|---|
.booth/ |
Booth runtime directory (project-local) |
.booth/booth.db |
Daemon state + reports (SQLite). Use booth reports CLI to read |
.booth/logs/ |
Daemon logs |
References
| Reference | Content |
|---|---|
references/signals.md |
Signal architecture, reactor rules, check/alert/beat flow |
references/cli.md |
CLI command reference, workflows, troubleshooting |
Role-Specific Skills
DJ and Deck each have dedicated skills with full operational protocols:
| Skill | Content |
|---|---|
booth-dj |
DJ management handbook — alert/beat response, deck management, report review |
booth-deck |
Deck execution protocol — check procedure, review loop, report format |