Files

190 lines
9.0 KiB
HTML
Raw Permalink Normal View History

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Bot Commands — Huskies Docs</title>
<meta name="description" content="Full reference of huskies bot commands available in Matrix, Slack, WhatsApp, Discord, and the web UI.">
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Bricolage+Grotesque:wght@400;500;600;700;800&family=Karla:ital,wght@0,300;0,400;0,500;1,300;1,400&display=swap" rel="stylesheet">
<link rel="stylesheet" href="docs.css">
</head>
<body>
<div class="shell">
<header class="reveal r1">
<a href="/" class="logo">huskies</a>
<nav>
<a href="/#how">How it works</a>
<a href="/#features">Features</a>
<a href="/docs/" class="active">Docs</a>
<a href="https://code.crashlabs.io/crashlabs/huskies">Source</a>
<a href="https://code.crashlabs.io/crashlabs/huskies/releases">Releases</a>
<a href="mailto:hello@huskies.dev" class="nav-cta">Get in touch</a>
</nav>
</header>
</div>
<div class="shell">
<div class="docs-layout">
<aside class="sidebar reveal r2">
<div class="sidebar-section">
<div class="sidebar-heading">Getting started</div>
<nav>
<a href="/docs/">Overview</a>
<a href="quickstart.html">Quickstart</a>
</nav>
</div>
<div class="sidebar-section">
<div class="sidebar-heading">Reference</div>
<nav>
<a href="configuration.html">Configuration</a>
<a href="commands.html" class="active">Bot commands</a>
<a href="cli.html">CLI</a>
</nav>
</div>
<div class="sidebar-section">
<div class="sidebar-heading">Guides</div>
<nav>
<a href="pipeline.html">Pipeline stages</a>
<a href="transports.html">Chat transports</a>
</nav>
</div>
</aside>
<main class="docs-main reveal r3">
<h1 class="page-title">Bot Commands</h1>
<p class="page-subtitle">Commands available in every chat transport (Matrix, Slack, WhatsApp, Discord) and the built-in web UI. Commands are case-insensitive. Run <code>help</code> in any chat to see the list.</p>
<div class="note">
<strong>How to invoke:</strong> In chat rooms, address the bot first (e.g. <code>@huskies start 42</code>) or enable ambient mode so it responds to all messages. In the web UI, type commands directly.
</div>
<h2>Pipeline management</h2>
<div class="cmd-grid">
<div class="cmd-row">
<div class="cmd-name">status</div>
<div class="cmd-desc">Show pipeline status and agent availability. Use <code>status &lt;number&gt;</code> for a detailed triage dump on a specific story.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">start</div>
<div class="cmd-desc">Start an agent on a story: <code>start &lt;number&gt;</code>. To use the opus model: <code>start &lt;number&gt; opus</code>.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">move</div>
<div class="cmd-desc">Move a work item to a pipeline stage: <code>move &lt;number&gt; &lt;stage&gt;</code>. Stages: <code>backlog</code>, <code>current</code>, <code>qa</code>, <code>merge</code>, <code>done</code>.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">show</div>
<div class="cmd-desc">Display the full text of a work item: <code>show &lt;number&gt;</code>.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">delete</div>
<div class="cmd-desc">Remove a work item from the pipeline: <code>delete &lt;number&gt;</code>.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">unblock</div>
<div class="cmd-desc">Reset a blocked story: <code>unblock &lt;number&gt;</code>. Clears the blocked flag and resets the retry count.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">assign</div>
<div class="cmd-desc">Pre-assign a model to a story before starting: <code>assign &lt;number&gt; &lt;model&gt;</code> (e.g. <code>assign 42 opus</code>).</div>
</div>
<div class="cmd-row">
<div class="cmd-name">backlog</div>
<div class="cmd-desc">Show all items in the backlog with dependency satisfaction status — which are ready to start and which are still waiting on other stories.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">depends</div>
<div class="cmd-desc">Set story dependencies: <code>depends &lt;number&gt; [dep1 dep2 ...]</code>. Call with no deps to clear all dependencies.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">timer</div>
<div class="cmd-desc">Schedule a deferred agent start: <code>timer &lt;number&gt; HH:MM</code>. List all timers: <code>timer list</code>. Cancel: <code>timer cancel &lt;number&gt;</code>. Times are interpreted in the project timezone.</div>
</div>
</div>
<h2>Worktrees</h2>
<div class="cmd-grid">
<div class="cmd-row">
<div class="cmd-name">rmtree</div>
<div class="cmd-desc">Delete the worktree for a story without removing the story from the pipeline: <code>rmtree &lt;number&gt;</code>. Useful for freeing disk space on a story that needs to be restarted.</div>
</div>
</div>
<h2>Observability</h2>
<div class="cmd-grid">
<div class="cmd-row">
<div class="cmd-name">cost</div>
<div class="cmd-desc">Show token spend: 24h total, top stories, breakdown by agent type, and all-time total.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">coverage</div>
<div class="cmd-desc">Show test coverage from the cached baseline. Use <code>coverage run</code> to rerun the full test suite and regenerate the report.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">git</div>
<div class="cmd-desc">Show git status for the main repository: current branch, uncommitted changes, and ahead/behind remote.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">htop</div>
<div class="cmd-desc">Live system and agent process dashboard. Use <code>htop</code> to start, <code>htop 10m</code> to run for 10 minutes, <code>htop stop</code> to stop.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">run_tests</div>
<div class="cmd-desc">Run the project's test suite (<code>script/test</code>) and show a pass/fail summary with output. Use <code>run_tests &lt;number&gt;</code> to run tests inside a specific story's worktree instead of the project root.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">loc</div>
<div class="cmd-desc">Show top source files by line count: <code>loc</code> (top 10), <code>loc &lt;N&gt;</code> for N files, or <code>loc &lt;filepath&gt;</code> for a specific file.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">overview</div>
<div class="cmd-desc">Show an implementation summary for a merged story: <code>overview &lt;number&gt;</code>.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">unreleased</div>
<div class="cmd-desc">Show stories merged to master since the last release tag.</div>
</div>
</div>
<h2>Server management</h2>
<div class="cmd-grid">
<div class="cmd-row">
<div class="cmd-name">rebuild</div>
<div class="cmd-desc">Rebuild the huskies server binary and restart the process.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">reset</div>
<div class="cmd-desc">Clear the current Claude Code session and start a fresh context window.</div>
</div>
</div>
<h2>Setup &amp; configuration</h2>
<div class="cmd-grid">
<div class="cmd-row">
<div class="cmd-name">setup</div>
<div class="cmd-desc">Show setup wizard progress. Drive the wizard from chat: <code>setup generate</code>, <code>setup confirm</code>, <code>setup skip</code>, <code>setup retry</code>.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">ambient</div>
<div class="cmd-desc">Toggle ambient mode for the current room: <code>ambient on</code> or <code>ambient off</code>. In ambient mode the bot responds to all messages, not just addressed ones.</div>
</div>
<div class="cmd-row">
<div class="cmd-name">help</div>
<div class="cmd-desc">Show the list of available commands.</div>
</div>
</div>
</main>
</div>
<footer class="reveal r3">
<span>&copy; 2026 Libby Labs Ltd.</span>
<a href="/privacy.html">Privacy Policy</a>
</footer>
</div>
</body>
</html>