# 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`).
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.
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.