Bot Commands

Commands available in every chat transport (Matrix, Slack, WhatsApp, Discord) and the built-in web UI. Commands are case-insensitive. Run help in any chat to see the list.

How to invoke: In chat rooms, address the bot first (e.g. @huskies start 42) or enable ambient mode so it responds to all messages. In the web UI, type commands directly.

Pipeline management

status
Show pipeline status and agent availability. Use status <number> for a detailed triage dump on a specific story.
start
Start an agent on a story: start <number>. To use the opus model: start <number> opus.
move
Move a work item to a pipeline stage: move <number> <stage>. Stages: backlog, current, qa, merge, done.
show
Display the full text of a work item: show <number>.
delete
Remove a work item from the pipeline: delete <number>.
unblock
Reset a blocked story: unblock <number>. Clears the blocked flag and resets the retry count.
assign
Pre-assign a model to a story before starting: assign <number> <model> (e.g. assign 42 opus).
backlog
Show all items in the backlog with dependency satisfaction status — which are ready to start and which are still waiting on other stories.
depends
Set story dependencies: depends <number> [dep1 dep2 ...]. Call with no deps to clear all dependencies.
timer
Schedule a deferred agent start: timer <number> HH:MM. List all timers: timer list. Cancel: timer cancel <number>. Times are interpreted in the project timezone.

Worktrees

rmtree
Delete the worktree for a story without removing the story from the pipeline: rmtree <number>. Useful for freeing disk space on a story that needs to be restarted.

Observability

cost
Show token spend: 24h total, top stories, breakdown by agent type, and all-time total.
coverage
Show test coverage from the cached baseline. Use coverage run to rerun the full test suite and regenerate the report.
git
Show git status for the main repository: current branch, uncommitted changes, and ahead/behind remote.
htop
Live system and agent process dashboard. Use htop to start, htop 10m to run for 10 minutes, htop stop to stop.
run_tests
Run the project's test suite (script/test) and show a pass/fail summary with output. Use run_tests <number> to run tests inside a specific story's worktree instead of the project root.
loc
Show top source files by line count: loc (top 10), loc <N> for N files, or loc <filepath> for a specific file.
overview
Show an implementation summary for a merged story: overview <number>.
unreleased
Show stories merged to master since the last release tag.

Server management

rebuild
Rebuild the huskies server binary and restart the process.
reset
Clear the current Claude Code session and start a fresh context window.

Setup & configuration

setup
Show setup wizard progress. Drive the wizard from chat: setup generate, setup confirm, setup skip, setup retry.
ambient
Toggle ambient mode for the current room: ambient on or ambient off. In ambient mode the bot responds to all messages, not just addressed ones.
help
Show the list of available commands.