| name | b00t-maintenance |
| description | Access the b00t maintenance loop — check status, view cake token balance,
confirm exercise reminders, and inspect the research queue. The 👍🏻/👎🏻
vote tokens feed the probabilistic cake lottery resolved at pre-commit review.
|
| version | 1.0.0 |
| tags | ["b00t","maintenance","cake","adhd","health","reminder","loop","vote"] |
| applies_to | ["checking loop status","confirming reminders","viewing cake balance","understanding cake lottery","triggering research tasks"] |
| output_types | [".json",".md"] |
| allowed-tools | ["mcp__b00t-mcp__b00t_maintenance_status","mcp__b00t-mcp__b00t_agent_vote_submit","Bash"] |
What the Maintenance Loop Does
The b00t maintenance daemon runs a 15-minute OODA cycle:
- Exercise reminders — fires at configurable intervals; awaits
<|👍🏻|> confirmation
- Research soul queue drain — pulls pending
research-soul tasks and dispatches sm0l agents
- OODA cycle — Observe (collect metrics) → Orient (score useful-work) → Decide (next action) → Act (emit notification or ticket)
Start the daemon: just maintenance-start
Status check: b00t-cli maintenance status
Vote Token Format
Votes are embedded inline in agent output or commit messages:
| Token | Meaning | Effect |
|---|
<|👍🏻|> | Thumbs up — reminder confirmed / task useful | +1 lottery ticket |
<|👎🏻|> | Skip — snooze or mark not useful | no ticket |
Votes are harvested by the daemon on each OODA cycle. Multiple votes in a session accumulate.
Cake Lottery
The cake lottery is probabilistic, resolved at pre-commit review:
- Each
<|👍🏻|> vote earns one lottery ticket
- Win probability =
time_accuracy × useful_work_score (both 0.0–1.0)
time_accuracy: how closely exercise was confirmed within the reminder windowuseful_work_score: agent self-assessment of output quality for the session- Resolution:
b00t-cli cake ticket resolve runs at pre-commit hook
Cake Commands
b00t cake balance
b00t cake balance operator
b00t cake history
b00t cake history --limit=N
b00t cake search <query>
Troubleshooting
Daemon not running:
just maintenance-start
b00t-cli maintenance start --detach
Zellij not detected — daemon emits reminders via Zellij pane; if Zellij is absent,
reminders fall back to desktop notification (notify-send) or stderr. No votes are lost.
Vote not registered — confirm the token format is exact: <|👍🏻|> (no spaces inside pipes).
Run b00t-cli maintenance status to inspect the pending vote queue.
Related
just research-soul — trigger one research task immediatelymcp__b00t-mcp__b00t_agent_vote_submit — MCP tool to submit votes programmaticallymcp__b00t-mcp__b00t_maintenance_status — MCP tool for daemon status JSON
