CLI Reference
Complete reference for all /haiku:* commands
Complete reference for all H·AI·K·U commands. Commands are MCP prompts invoked as /haiku:<command> in any MCP client (Claude Code, Cursor, Windsurf, etc.).
Core Commands
/haiku:haiku-start
Create a new intent with studio and stage configuration.
- Detects or prompts for studio selection (software, ideation, or custom)
- Selects execution mode (continuous or discrete stages)
- Resolves stages from the selected studio
- Creates
.haiku/intents/{slug}/workspace with intent and unit files - Sets up git branch
haiku/{slug}(software studio)
Arguments: description (optional) — describe what you want to build. template (optional) — instantiate from a studio intent template.
/haiku:haiku-pickup
Run the stage pipeline for the current intent. Progresses through each stage in order, transitioning through the hats defined in each stage's STAGE.md.
Arguments: intent (optional) — intent slug. Auto-detects if only one active intent.
/haiku:haiku-gate-review
Pre-delivery code review using multi-agent specialized review. Spawns parallel agents for correctness, security, performance, architecture, and test quality. Auto-fixes HIGH findings (up to 3 iterations).
Arguments: intent (optional) — intent slug.
/haiku:haiku-autopilot
Full autonomous workflow — create intent, run stages, review, and deliver in one command. Sets mode=autopilot and chains to /haiku:haiku-pickup.
Arguments: description (optional) — feature description.
/haiku:haiku-quick
Quick mode for small tasks — skip full pipeline. Streamlined single-stage workflow for fixes, renames, config changes, and small refactors.
Arguments: stage (optional) — stage name. description (required) — task description.
/haiku:haiku-zap
Zero-ceremony hat loop. No intent file, no unit decomposition, no workflow tick — runs the chosen stage's hats: sequence directly against the working tree as a chain of subagents (planner → builder → verifier). Parent skill commits once after the verifier returns PASS — <summary> with a confirmed Files list. Capped at 2 retries.
Use for: typos, one-line config tweaks, small bug fixes — work where the cost of a mistake is "edit and re-run." Use /haiku:haiku-quick or /haiku:haiku-start for anything that crosses stages or needs traceability.
Arguments: studio (optional, defaults to software) — studio slug. stage (optional, defaults to the studio's primary execution stage, e.g. development for software) — stage within the studio. description (required) — task description.
Preflight: zap refuses to start on a dirty working tree without explicit consent — it will list the dirty paths and ask whether to abort or proceed (and instruct the builder to leave those paths alone).
Intent Management
/haiku:haiku-refine
Refine intent or unit specs mid-execution without losing progress. Loads upstream stage context for scoped side-trips.
Arguments: stage (optional) — upstream stage to refine.
Reflection has no command — when an intent completes, the engine analyzes the run automatically along the active studio's reflection dimensions and writes the reflection artifact before sealing the intent.
Knowledge & Analysis
/haiku:haiku-ideate
Surface high-impact improvement ideas with adversarial filtering. Generates ideas across multiple dimensions and filters via counter-argument.
Arguments: area (optional) — focus area for brainstorming.
/haiku:haiku-adopt
Reverse-engineer an existing feature into H·AI·K·U intent artifacts. Explores a shipped feature by reading its code, tests, and docs, then generates intent and unit specs.
Arguments: description (optional) — feature description.
/haiku:haiku-capacity
Historical throughput analysis from local artifacts. Analyzes completed intents, units, and bolts to surface velocity trends and bottleneck stages.
Arguments: studio (optional) — scope analysis to a specific studio.
/haiku:haiku-changelog
Show the project changelog and release notes.
Arguments: version (optional) — specific version to show.
Quality & Process
/haiku:haiku-pressure-testing
Adversarial challenge for hat definitions. Applies RED-GREEN-REFACTOR cycle to test hat instructions under pressure types.
Arguments: hat (optional) — hat name to test.
Cross-Studio & Triggers
/haiku:haiku-composite
Create a multi-studio intent with sync points. Coordinates work across studios.
Arguments: description (optional) — what the composite intent addresses.
/haiku:haiku-triggers
Poll providers for events that unblock await gates or trigger new work.
Arguments: category (optional) — provider category to poll.
/haiku:haiku-backlog
Parking lot for ideas not yet ready for planning.
Arguments: action (optional) — add, list, review, or promote. description (optional) — for add action.
Managing Intents
Archiving is a soft-hide flag on the intent, not a move or delete — .haiku/intents/{slug} stays exactly where it is, branches and history untouched. Trigger it with /haiku:haiku-archive <slug> on anything completed, stale, or paused; archived intents drop out of /haiku:haiku-capacity and the default haiku_intent_list output. To see them, call haiku_intent_list with include_archived: true — the response tags each entry with an archived field so you can tell what's hidden. Restore with /haiku:haiku-unarchive <slug> and the intent is back in every default view.
/haiku:haiku-archive
Soft-hide an intent by setting an archived flag in its frontmatter — files stay in .haiku/intents/{slug}, history is preserved.
Arguments: intent (optional) — slug of intent to archive. If omitted, the skill prompts you to pick from the visible intents.
/haiku:haiku-unarchive
Clear the archived flag so the intent reappears in default list views.
Arguments: intent (optional) — slug of intent to restore. If omitted, the skill prompts you to pick from the archived intents.
/haiku:haiku-scaffold
Generate custom studios, stages, hats, and provider overrides.
Arguments: type (required) — studio, stage, hat, or provider. name (required) — name for the artifact. parent (optional) — parent context.
/haiku:haiku-migrate
Migrate legacy .ai-dlc intents to H·AI·K·U format.
Arguments: intent (optional) — specific intent slug to migrate.
/haiku:haiku-seed
Create intents from studio templates.
Arguments: action (optional) — plant, list, or check.
/haiku:haiku-setup
Configure H·AI·K·U providers and workspace settings.