ZERG Command Quick Reference
Fast lookup for experienced users. For detailed explanations, see Command Guide.
Global Flags
Analysis Depth (mutually exclusive)
| Flag |
Tokens |
Description |
--quick |
~1K |
Surface-level, fast execution |
--think |
~4K |
Structured multi-step analysis |
--think-hard |
~10K |
Deep architectural analysis |
--ultrathink |
~32K |
Maximum depth, all MCP servers |
Output & Efficiency
| Flag |
Type |
Default |
Description |
--no-compact |
bool |
false |
Disable compact output |
Behavioral Mode
| Flag |
Type |
Default |
Description |
--mode |
string |
auto |
Override mode: precision, speed, exploration, refactor, debug |
MCP Routing
| Flag |
Type |
Default |
Description |
--mcp |
bool |
true |
Enable MCP auto-routing |
--no-mcp |
bool |
false |
Disable all MCP servers |
Improvement Loops
| Flag |
Type |
Default |
Description |
--no-loop |
bool |
false |
Disable improvement loops |
--iterations |
int |
config |
Max loop iterations |
TDD & Standard
| Flag |
Type |
Default |
Description |
--tdd |
bool |
false |
Enable TDD enforcement |
--verbose / -v |
bool |
false |
Verbose output |
--quiet / -q |
bool |
false |
Suppress non-essential output |
--version |
bool |
false |
Show version |
--help |
bool |
false |
Show help |
Core Workflow
/zerg:brainstorm
Open-ended feature discovery with competitive research and GitHub issue creation.
| Flag |
Type |
Default |
Description |
--rounds |
int |
3 |
Socratic discovery rounds (max 5) |
--socratic |
bool |
false |
Single-question mode with domain trees |
--skip-research |
bool |
false |
Skip web research phase |
--skip-issues |
bool |
false |
Don't create GitHub issues |
--dry-run |
bool |
false |
Preview issues only |
--resume |
bool |
false |
Resume from checkpoint |
/zerg:design
Generate architecture and task graph for parallel execution.
| Flag |
Type |
Default |
Description |
--help |
bool |
false |
Show help |
Prerequisite: .gsd/specs/{feature}/requirements.md with APPROVED status.
/zerg:init
Initialize ZERG for a project. Inception mode (empty dir) or Discovery mode (existing project).
| Flag |
Type |
Default |
Description |
--workers |
int |
5 |
Default worker count |
--security |
string |
"" |
Security level (e.g., strict) |
--no-security-rules |
bool |
false |
Skip TikiTribe security rules |
--with-containers |
bool |
false |
Build devcontainer after init |
/zerg:plan
Capture requirements through interactive questioning.
| Flag |
Type |
Default |
Description |
--socratic / -s |
bool |
false |
Structured 3-round discovery |
--rounds |
int |
3 |
Socratic rounds (max 5) |
--from-issue |
string |
"" |
Import requirements from GitHub issue URL |
/zerg:rush
Launch parallel workers to execute task graph.
| Flag |
Type |
Default |
Description |
--workers / -w |
int |
5 |
Parallel workers (max 10) |
--feature / -f |
string |
auto |
Feature name |
--level / -l |
int |
1 |
Start from level |
--task-graph / -g |
string |
auto |
Path to task-graph.json |
--mode / -m |
string |
task |
Mode: subprocess, container, task |
--dry-run |
bool |
false |
Show plan only |
--resume |
bool |
false |
Continue previous run |
--timeout |
int |
3600 |
Max seconds |
--check-gates |
bool |
false |
Pre-run quality gates during dry-run |
--what-if |
bool |
false |
Compare different worker counts and modes |
--risk |
bool |
false |
Show risk assessment for task graph |
--skip-tests |
bool |
false |
Skip test gates (lint-only mode) |
Monitoring & Control
/zerg:cleanup
Remove ZERG artifacts and free resources.
| Flag |
Type |
Default |
Description |
--feature / -f |
string |
"" |
Feature to clean (required unless --all) |
--all |
bool |
false |
Clean all features |
--keep-logs |
bool |
false |
Preserve logs |
--keep-branches |
bool |
false |
Preserve git branches |
--dry-run |
bool |
false |
Preview only |
/zerg:logs
Stream, filter, and aggregate worker logs.
| Flag |
Type |
Default |
Description |
WORKER_ID |
int |
all |
Filter to worker (positional) |
--feature / -f |
string |
auto |
Feature name |
--tail / -n |
int |
100 |
Lines to show |
--follow |
bool |
false |
Stream continuously |
--level / -l |
string |
all |
Filter: debug, info, warn, error |
--json |
bool |
false |
Raw JSON output |
--aggregate |
bool |
false |
Merge all logs by timestamp |
--task |
string |
"" |
Filter to task ID |
--artifacts |
string |
"" |
Show task artifacts |
--phase |
string |
"" |
Filter: claim, execute, verify, commit, cleanup |
--event |
string |
"" |
Filter by event type |
--since |
string |
"" |
After ISO8601 timestamp |
--until |
string |
"" |
Before ISO8601 timestamp |
--search |
string |
"" |
Text search |
/zerg:merge
Manually trigger level merge operations.
| Flag |
Type |
Default |
Description |
--level / -l |
int |
current |
Merge specific level |
--force / -f |
bool |
false |
Force despite conflicts |
--abort |
bool |
false |
Abort in-progress merge |
--dry-run |
bool |
false |
Preview only |
--skip-gates |
bool |
false |
Skip quality gates |
--no-rebase |
bool |
false |
Don't rebase after merge |
--target / -t |
string |
main |
Target branch |
/zerg:retry
Retry failed or blocked tasks.
| Flag |
Type |
Default |
Description |
TASK_IDS |
string[] |
[] |
Task IDs to retry (positional) |
--level / -l |
int |
0 |
Retry all failed in level |
--all / -a |
bool |
false |
Retry all failed |
--force / -f |
bool |
false |
Bypass retry limit |
--timeout / -t |
int |
config |
Override timeout |
--reset |
bool |
false |
Reset retry counters |
--dry-run |
bool |
false |
Preview only |
--worker / -w |
int |
— |
Assign task to specific worker |
/zerg:status
Display real-time execution progress.
| Flag |
Type |
Default |
Description |
--feature / -f |
string |
auto |
Feature to show |
--watch / -w |
bool |
false |
Continuous update |
--interval / -i |
int |
5 |
Watch refresh seconds |
--level / -l |
int |
all |
Filter to level |
--json |
bool |
false |
JSON output |
--dashboard / -d |
bool |
false |
TUI dashboard (CLI only) |
--tasks |
bool |
false |
Show all tasks |
--workers |
bool |
false |
Detailed worker info |
--commits |
bool |
false |
Recent commits per branch |
/zerg:stop
Stop workers gracefully or forcefully.
| Flag |
Type |
Default |
Description |
--feature / -f |
string |
auto |
Feature to stop |
--worker / -w |
int |
all |
Stop specific worker |
--force |
bool |
false |
Immediate termination |
--timeout |
int |
30 |
Graceful shutdown seconds |
Quality & Analysis
/zerg:analyze
Static analysis, complexity metrics, and quality assessment.
| Flag |
Type |
Default |
Description |
--check |
string |
all |
Check: lint, complexity, coverage, security, all |
--format |
string |
text |
Output: text, json, sarif |
--threshold |
string |
defaults |
Custom thresholds |
--files |
string |
all |
Restrict to files |
--performance |
bool |
false |
Run comprehensive performance audit (140 factors) |
/zerg:build
Build orchestration with auto-detection and error recovery.
| Flag |
Type |
Default |
Description |
--target |
string |
all |
Build target |
--mode |
string |
dev |
Mode: dev, staging, prod |
--clean |
bool |
false |
Clean build |
--watch |
bool |
false |
Rebuild on changes |
--retry |
int |
3 |
Retries on failure |
/zerg:refactor
Automated code improvement and cleanup.
| Flag |
Type |
Default |
Description |
--transforms |
string |
all |
Transforms: dead-code, simplify, types, patterns, naming |
--dry-run |
bool |
false |
Preview only |
--interactive |
bool |
false |
Approve one by one |
/zerg:review
Three-stage code review workflow (Spec → Quality → Security).
| Flag |
Type |
Default |
Description |
--mode |
string |
full |
Mode: prepare, self, receive, full |
--no-security |
bool |
false |
Skip Stage 3 security scan |
/zerg:security
Security scanning and rules management.
| Flag |
Type |
Default |
Description |
--preset |
string |
owasp |
Compliance: owasp, pci, hipaa, soc2 |
--autofix |
bool |
false |
Generate fix suggestions |
--format |
string |
text |
Output: text, json, sarif |
CLI subcommand: zerg security-rules detect|list|fetch|integrate
/zerg:test
Execute tests with coverage and generation.
| Flag |
Type |
Default |
Description |
--generate |
bool |
false |
Generate test stubs |
--coverage |
bool |
false |
Report coverage |
--watch |
bool |
false |
Continuous testing |
--parallel |
int |
auto |
Test workers |
--framework |
string |
auto |
Force: pytest, jest, cargo, go |
Utilities
/zerg:create-command
Scaffold new ZERG commands with Task integration and tests.
| Flag |
Type |
Default |
Description |
<name> |
string |
required |
Command name |
--interactive |
bool |
false |
Enable wizard |
/zerg:debug
Deep diagnostic investigation with error intelligence.
| Flag |
Type |
Default |
Description |
--feature / -f |
string |
auto |
Feature to investigate |
--worker / -w |
int |
all |
Focus on worker |
--deep |
bool |
false |
System-level diagnostics |
--fix |
bool |
false |
Generate recovery plan |
--error / -e |
string |
"" |
Error message to analyze |
--stacktrace / -s |
string |
"" |
Path to stack trace |
--env |
bool |
false |
Environment diagnostics |
--interactive / -i |
bool |
false |
Wizard mode |
--report |
string |
"" |
Write report to file |
/zerg:git
Git operations with intelligent commits, PRs, releases, and more.
| Flag |
Type |
Default |
Description |
--action / -a |
string |
commit |
Action (see below) |
--push / -p |
bool |
false |
Push after commit |
--base / -b |
string |
main |
Base branch |
--name / -n |
string |
"" |
Branch name |
--branch |
string |
"" |
Branch to merge |
--strategy |
string |
squash |
Merge: merge, squash, rebase |
--since |
string |
"" |
History start point |
--mode |
string |
auto |
Commit: auto, confirm, suggest |
--cleanup |
bool |
false |
History cleanup |
--draft |
bool |
false |
Draft PR |
--reviewer |
string |
"" |
PR reviewer |
--focus |
string |
"" |
Review: security, performance, quality, architecture |
--bump |
string |
auto |
Release: auto, major, minor, patch |
--dry-run |
bool |
false |
Preview only |
--symptom |
string |
"" |
Bug symptom (bisect) |
--test-cmd |
string |
"" |
Test command (bisect) |
--good |
string |
"" |
Known good ref (bisect) |
--list-ops |
bool |
false |
List rescue operations |
--undo |
bool |
false |
Undo last operation |
--restore |
string |
"" |
Restore snapshot |
--recover-branch |
string |
"" |
Recover deleted branch |
--no-merge |
bool |
false |
Stop after PR creation |
--admin |
bool |
false |
Use admin merge directly (repo owner/admin, for ship) |
--stale-days |
int |
30 |
Branch age for cleanup |
--title |
string |
"" |
Issue title |
--label |
string |
"" |
Issue label |
--assignee |
string |
"" |
Issue assignee |
--no-docker |
bool |
false |
Skip Docker cleanup |
--include-stashes |
bool |
false |
Clear stashes |
--limit |
int |
10 |
Max issues |
--priority |
string |
"" |
Filter: P0, P1, P2 |
Actions: commit, branch, merge, sync, history, finish, pr, release, review, rescue, bisect, ship, cleanup, issue
/zerg:plugins
Extend ZERG with quality gates, hooks, and launchers.
| Flag |
Type |
Default |
Description |
--help |
bool |
false |
Show documentation |
/zerg:worker
Internal worker protocol. Invoked by orchestrator.
| Env Var |
Default |
Description |
ZERG_WORKER_ID |
0 |
Worker ID |
ZERG_FEATURE |
unknown |
Feature name |
ZERG_BRANCH |
main |
Base branch |
Documentation & AI
/zerg:document
Generate documentation for a single component.
| Flag |
Type |
Default |
Description |
<target> |
string |
required |
File or module to document |
--type |
string |
auto |
Type: auto, module, command, config, api, types |
--output |
string |
stdout |
Output path |
--depth |
string |
standard |
Depth: shallow, standard, deep |
--tone |
string |
educational |
Documentation tone: educational, reference, tutorial |
--update |
bool |
false |
Update in-place |
/zerg:estimate
PERT effort estimation with post-execution comparison.
| Flag |
Type |
Default |
Description |
<feature> |
string |
auto |
Feature to estimate |
--pre |
bool |
auto |
Force pre-execution mode |
--post |
bool |
auto |
Force post-execution mode |
--calibrate |
bool |
false |
Show historical accuracy |
--workers |
int |
config |
Worker count for projection |
--format |
string |
text |
Output: text, json, md |
--verbose |
bool |
false |
Per-task breakdown |
--history |
bool |
false |
Show past estimates |
--no-calibration |
bool |
false |
Skip bias application |
/zerg:explain
Educational code explanations with four depth layers.
| Flag |
Type |
Default |
Description |
<target> |
string |
required |
File, file:func, directory, or module |
--scope |
string |
auto |
Override: function, file, module, system |
--save |
bool |
false |
Write to claudedocs/ |
--format |
string |
text |
Output: text, md, json |
--no-diagrams |
bool |
false |
Skip Mermaid diagrams |
/zerg:index
Generate complete documentation wiki.
| Flag |
Type |
Default |
Description |
--full |
bool |
false |
Regenerate all pages |
--push |
bool |
false |
Push to wiki.git |
--dry-run |
bool |
false |
Preview only |
--output |
string |
.gsd/wiki/ |
Output directory |
/zerg:select-tool
Intelligent tool routing across MCP, native tools, and agents.
| Flag |
Type |
Default |
Description |
<task description> |
string |
required |
Task to analyze |
--domain |
string |
auto |
Override: ui, backend, infra, docs, test, security, perf |
--format |
string |
text |
Output: text, json, md |
--verbose |
bool |
false |
Per-dimension scoring |
--no-agents |
bool |
false |
Exclude agent recommendations |
--no-mcp |
bool |
false |
Exclude MCP recommendations |
Exit Codes
| Code |
Meaning |
| 0 |
Success |
| 1 |
Failure |
| 2 |
Configuration error / worker checkpoint |
| 4 |
Worker escalated ambiguous failure |
1---2name: zerg-command-quick-reference3description: Fast lookup for experienced users. For detailed explanations, see Command Guide.4---5# ZERG Command Quick Reference67Fast lookup for experienced users. For detailed explanations, see [Command Guide](commands-deep.md).89---1011## Global Flags1213### Analysis Depth (mutually exclusive)1415| Flag | Tokens | Description |16|------|--------|-------------|17| `--quick` | ~1K | Surface-level, fast execution |18| `--think` | ~4K | Structured multi-step analysis |19| `--think-hard` | ~10K | Deep architectural analysis |20| `--ultrathink` | ~32K | Maximum depth, all MCP servers |2122### Output & Efficiency2324| Flag | Type | Default | Description |25|------|------|---------|-------------|26| `--no-compact` | bool | false | Disable compact output |2728### Behavioral Mode2930| Flag | Type | Default | Description |31|------|------|---------|-------------|32| `--mode` | string | auto | Override mode: `precision`, `speed`, `exploration`, `refactor`, `debug` |3334### MCP Routing3536| Flag | Type | Default | Description |37|------|------|---------|-------------|38| `--mcp` | bool | true | Enable MCP auto-routing |39| `--no-mcp` | bool | false | Disable all MCP servers |4041### Improvement Loops4243| Flag | Type | Default | Description |44|------|------|---------|-------------|45| `--no-loop` | bool | false | Disable improvement loops |46| `--iterations` | int | config | Max loop iterations |4748### TDD & Standard4950| Flag | Type | Default | Description |51|------|------|---------|-------------|52| `--tdd` | bool | false | Enable TDD enforcement |53| `--verbose` / `-v` | bool | false | Verbose output |54| `--quiet` / `-q` | bool | false | Suppress non-essential output |55| `--version` | bool | false | Show version |56| `--help` | bool | false | Show help |5758---5960## Core Workflow6162### /zerg:brainstorm6364Open-ended feature discovery with competitive research and GitHub issue creation.6566| Flag | Type | Default | Description |67|------|------|---------|-------------|68| `--rounds` | int | 3 | Socratic discovery rounds (max 5) |69| `--socratic` | bool | false | Single-question mode with domain trees |70| `--skip-research` | bool | false | Skip web research phase |71| `--skip-issues` | bool | false | Don't create GitHub issues |72| `--dry-run` | bool | false | Preview issues only |73| `--resume` | bool | false | Resume from checkpoint |7475### /zerg:design7677Generate architecture and task graph for parallel execution.7879| Flag | Type | Default | Description |80|------|------|---------|-------------|81| `--help` | bool | false | Show help |8283Prerequisite: `.gsd/specs/{feature}/requirements.md` with APPROVED status.8485### /zerg:init8687Initialize ZERG for a project. Inception mode (empty dir) or Discovery mode (existing project).8889| Flag | Type | Default | Description |90|------|------|---------|-------------|91| `--workers` | int | 5 | Default worker count |92| `--security` | string | "" | Security level (e.g., `strict`) |93| `--no-security-rules` | bool | false | Skip TikiTribe security rules |94| `--with-containers` | bool | false | Build devcontainer after init |9596### /zerg:plan9798Capture requirements through interactive questioning.99100| Flag | Type | Default | Description |101|------|------|---------|-------------|102| `--socratic` / `-s` | bool | false | Structured 3-round discovery |103| `--rounds` | int | 3 | Socratic rounds (max 5) |104| `--from-issue` | string | "" | Import requirements from GitHub issue URL |105106### /zerg:rush107108Launch parallel workers to execute task graph.109110| Flag | Type | Default | Description |111|------|------|---------|-------------|112| `--workers` / `-w` | int | 5 | Parallel workers (max 10) |113| `--feature` / `-f` | string | auto | Feature name |114| `--level` / `-l` | int | 1 | Start from level |115| `--task-graph` / `-g` | string | auto | Path to task-graph.json |116| `--mode` / `-m` | string | task | Mode: `subprocess`, `container`, `task` |117| `--dry-run` | bool | false | Show plan only |118| `--resume` | bool | false | Continue previous run |119| `--timeout` | int | 3600 | Max seconds |120| `--check-gates` | bool | false | Pre-run quality gates during dry-run |121| `--what-if` | bool | false | Compare different worker counts and modes |122| `--risk` | bool | false | Show risk assessment for task graph |123| `--skip-tests` | bool | false | Skip test gates (lint-only mode) |124125---126127## Monitoring & Control128129### /zerg:cleanup130131Remove ZERG artifacts and free resources.132133| Flag | Type | Default | Description |134|------|------|---------|-------------|135| `--feature` / `-f` | string | "" | Feature to clean (required unless `--all`) |136| `--all` | bool | false | Clean all features |137| `--keep-logs` | bool | false | Preserve logs |138| `--keep-branches` | bool | false | Preserve git branches |139| `--dry-run` | bool | false | Preview only |140141### /zerg:logs142143Stream, filter, and aggregate worker logs.144145| Flag | Type | Default | Description |146|------|------|---------|-------------|147| `WORKER_ID` | int | all | Filter to worker (positional) |148| `--feature` / `-f` | string | auto | Feature name |149| `--tail` / `-n` | int | 100 | Lines to show |150| `--follow` | bool | false | Stream continuously |151| `--level` / `-l` | string | all | Filter: `debug`, `info`, `warn`, `error` |152| `--json` | bool | false | Raw JSON output |153| `--aggregate` | bool | false | Merge all logs by timestamp |154| `--task` | string | "" | Filter to task ID |155| `--artifacts` | string | "" | Show task artifacts |156| `--phase` | string | "" | Filter: `claim`, `execute`, `verify`, `commit`, `cleanup` |157| `--event` | string | "" | Filter by event type |158| `--since` | string | "" | After ISO8601 timestamp |159| `--until` | string | "" | Before ISO8601 timestamp |160| `--search` | string | "" | Text search |161162### /zerg:merge163164Manually trigger level merge operations.165166| Flag | Type | Default | Description |167|------|------|---------|-------------|168| `--level` / `-l` | int | current | Merge specific level |169| `--force` / `-f` | bool | false | Force despite conflicts |170| `--abort` | bool | false | Abort in-progress merge |171| `--dry-run` | bool | false | Preview only |172| `--skip-gates` | bool | false | Skip quality gates |173| `--no-rebase` | bool | false | Don't rebase after merge |174| `--target` / `-t` | string | main | Target branch |175176### /zerg:retry177178Retry failed or blocked tasks.179180| Flag | Type | Default | Description |181|------|------|---------|-------------|182| `TASK_IDS` | string[] | [] | Task IDs to retry (positional) |183| `--level` / `-l` | int | 0 | Retry all failed in level |184| `--all` / `-a` | bool | false | Retry all failed |185| `--force` / `-f` | bool | false | Bypass retry limit |186| `--timeout` / `-t` | int | config | Override timeout |187| `--reset` | bool | false | Reset retry counters |188| `--dry-run` | bool | false | Preview only |189| `--worker` / `-w` | int | — | Assign task to specific worker |190191### /zerg:status192193Display real-time execution progress.194195| Flag | Type | Default | Description |196|------|------|---------|-------------|197| `--feature` / `-f` | string | auto | Feature to show |198| `--watch` / `-w` | bool | false | Continuous update |199| `--interval` / `-i` | int | 5 | Watch refresh seconds |200| `--level` / `-l` | int | all | Filter to level |201| `--json` | bool | false | JSON output |202| `--dashboard` / `-d` | bool | false | TUI dashboard (CLI only) |203| `--tasks` | bool | false | Show all tasks |204| `--workers` | bool | false | Detailed worker info |205| `--commits` | bool | false | Recent commits per branch |206207### /zerg:stop208209Stop workers gracefully or forcefully.210211| Flag | Type | Default | Description |212|------|------|---------|-------------|213| `--feature` / `-f` | string | auto | Feature to stop |214| `--worker` / `-w` | int | all | Stop specific worker |215| `--force` | bool | false | Immediate termination |216| `--timeout` | int | 30 | Graceful shutdown seconds |217218---219220## Quality & Analysis221222### /zerg:analyze223224Static analysis, complexity metrics, and quality assessment.225226| Flag | Type | Default | Description |227|------|------|---------|-------------|228| `--check` | string | all | Check: `lint`, `complexity`, `coverage`, `security`, `all` |229| `--format` | string | text | Output: `text`, `json`, `sarif` |230| `--threshold` | string | defaults | Custom thresholds |231| `--files` | string | all | Restrict to files |232| `--performance` | bool | false | Run comprehensive performance audit (140 factors) |233234### /zerg:build235236Build orchestration with auto-detection and error recovery.237238| Flag | Type | Default | Description |239|------|------|---------|-------------|240| `--target` | string | all | Build target |241| `--mode` | string | dev | Mode: `dev`, `staging`, `prod` |242| `--clean` | bool | false | Clean build |243| `--watch` | bool | false | Rebuild on changes |244| `--retry` | int | 3 | Retries on failure |245246### /zerg:refactor247248Automated code improvement and cleanup.249250| Flag | Type | Default | Description |251|------|------|---------|-------------|252| `--transforms` | string | all | Transforms: `dead-code`, `simplify`, `types`, `patterns`, `naming` |253| `--dry-run` | bool | false | Preview only |254| `--interactive` | bool | false | Approve one by one |255256### /zerg:review257258Three-stage code review workflow (Spec → Quality → Security).259260| Flag | Type | Default | Description |261|------|------|---------|-------------|262| `--mode` | string | full | Mode: `prepare`, `self`, `receive`, `full` |263| `--no-security` | bool | false | Skip Stage 3 security scan |264265### /zerg:security266267Security scanning and rules management.268269| Flag | Type | Default | Description |270|------|------|---------|-------------|271| `--preset` | string | owasp | Compliance: `owasp`, `pci`, `hipaa`, `soc2` |272| `--autofix` | bool | false | Generate fix suggestions |273| `--format` | string | text | Output: `text`, `json`, `sarif` |274275CLI subcommand: `zerg security-rules detect|list|fetch|integrate`276277### /zerg:test278279Execute tests with coverage and generation.280281| Flag | Type | Default | Description |282|------|------|---------|-------------|283| `--generate` | bool | false | Generate test stubs |284| `--coverage` | bool | false | Report coverage |285| `--watch` | bool | false | Continuous testing |286| `--parallel` | int | auto | Test workers |287| `--framework` | string | auto | Force: `pytest`, `jest`, `cargo`, `go` |288289---290291## Utilities292293### /zerg:create-command294295Scaffold new ZERG commands with Task integration and tests.296297| Flag | Type | Default | Description |298|------|------|---------|-------------|299| `<name>` | string | required | Command name |300| `--interactive` | bool | false | Enable wizard |301302### /zerg:debug303304Deep diagnostic investigation with error intelligence.305306| Flag | Type | Default | Description |307|------|------|---------|-------------|308| `--feature` / `-f` | string | auto | Feature to investigate |309| `--worker` / `-w` | int | all | Focus on worker |310| `--deep` | bool | false | System-level diagnostics |311| `--fix` | bool | false | Generate recovery plan |312| `--error` / `-e` | string | "" | Error message to analyze |313| `--stacktrace` / `-s` | string | "" | Path to stack trace |314| `--env` | bool | false | Environment diagnostics |315| `--interactive` / `-i` | bool | false | Wizard mode |316| `--report` | string | "" | Write report to file |317318### /zerg:git319320Git operations with intelligent commits, PRs, releases, and more.321322| Flag | Type | Default | Description |323|------|------|---------|-------------|324| `--action` / `-a` | string | commit | Action (see below) |325| `--push` / `-p` | bool | false | Push after commit |326| `--base` / `-b` | string | main | Base branch |327| `--name` / `-n` | string | "" | Branch name |328| `--branch` | string | "" | Branch to merge |329| `--strategy` | string | squash | Merge: `merge`, `squash`, `rebase` |330| `--since` | string | "" | History start point |331| `--mode` | string | auto | Commit: `auto`, `confirm`, `suggest` |332| `--cleanup` | bool | false | History cleanup |333| `--draft` | bool | false | Draft PR |334| `--reviewer` | string | "" | PR reviewer |335| `--focus` | string | "" | Review: `security`, `performance`, `quality`, `architecture` |336| `--bump` | string | auto | Release: `auto`, `major`, `minor`, `patch` |337| `--dry-run` | bool | false | Preview only |338| `--symptom` | string | "" | Bug symptom (bisect) |339| `--test-cmd` | string | "" | Test command (bisect) |340| `--good` | string | "" | Known good ref (bisect) |341| `--list-ops` | bool | false | List rescue operations |342| `--undo` | bool | false | Undo last operation |343| `--restore` | string | "" | Restore snapshot |344| `--recover-branch` | string | "" | Recover deleted branch |345| `--no-merge` | bool | false | Stop after PR creation |346| `--admin` | bool | false | Use admin merge directly (repo owner/admin, for ship) |347| `--stale-days` | int | 30 | Branch age for cleanup |348| `--title` | string | "" | Issue title |349| `--label` | string | "" | Issue label |350| `--assignee` | string | "" | Issue assignee |351| `--no-docker` | bool | false | Skip Docker cleanup |352| `--include-stashes` | bool | false | Clear stashes |353| `--limit` | int | 10 | Max issues |354| `--priority` | string | "" | Filter: `P0`, `P1`, `P2` |355356**Actions**: `commit`, `branch`, `merge`, `sync`, `history`, `finish`, `pr`, `release`, `review`, `rescue`, `bisect`, `ship`, `cleanup`, `issue`357358### /zerg:plugins359360Extend ZERG with quality gates, hooks, and launchers.361362| Flag | Type | Default | Description |363|------|------|---------|-------------|364| `--help` | bool | false | Show documentation |365366### /zerg:worker367368Internal worker protocol. Invoked by orchestrator.369370| Env Var | Default | Description |371|---------|---------|-------------|372| `ZERG_WORKER_ID` | 0 | Worker ID |373| `ZERG_FEATURE` | unknown | Feature name |374| `ZERG_BRANCH` | main | Base branch |375376---377378## Documentation & AI379380### /zerg:document381382Generate documentation for a single component.383384| Flag | Type | Default | Description |385|------|------|---------|-------------|386| `<target>` | string | required | File or module to document |387| `--type` | string | auto | Type: `auto`, `module`, `command`, `config`, `api`, `types` |388| `--output` | string | stdout | Output path |389| `--depth` | string | standard | Depth: `shallow`, `standard`, `deep` |390| `--tone` | string | `educational` | Documentation tone: `educational`, `reference`, `tutorial` |391| `--update` | bool | false | Update in-place |392393### /zerg:estimate394395PERT effort estimation with post-execution comparison.396397| Flag | Type | Default | Description |398|------|------|---------|-------------|399| `<feature>` | string | auto | Feature to estimate |400| `--pre` | bool | auto | Force pre-execution mode |401| `--post` | bool | auto | Force post-execution mode |402| `--calibrate` | bool | false | Show historical accuracy |403| `--workers` | int | config | Worker count for projection |404| `--format` | string | text | Output: `text`, `json`, `md` |405| `--verbose` | bool | false | Per-task breakdown |406| `--history` | bool | false | Show past estimates |407| `--no-calibration` | bool | false | Skip bias application |408409### /zerg:explain410411Educational code explanations with four depth layers.412413| Flag | Type | Default | Description |414|------|------|---------|-------------|415| `<target>` | string | required | File, `file:func`, directory, or module |416| `--scope` | string | auto | Override: `function`, `file`, `module`, `system` |417| `--save` | bool | false | Write to claudedocs/ |418| `--format` | string | text | Output: `text`, `md`, `json` |419| `--no-diagrams` | bool | false | Skip Mermaid diagrams |420421### /zerg:index422423Generate complete documentation wiki.424425| Flag | Type | Default | Description |426|------|------|---------|-------------|427| `--full` | bool | false | Regenerate all pages |428| `--push` | bool | false | Push to wiki.git |429| `--dry-run` | bool | false | Preview only |430| `--output` | string | .gsd/wiki/ | Output directory |431432### /zerg:select-tool433434Intelligent tool routing across MCP, native tools, and agents.435436| Flag | Type | Default | Description |437|------|------|---------|-------------|438| `<task description>` | string | required | Task to analyze |439| `--domain` | string | auto | Override: `ui`, `backend`, `infra`, `docs`, `test`, `security`, `perf` |440| `--format` | string | text | Output: `text`, `json`, `md` |441| `--verbose` | bool | false | Per-dimension scoring |442| `--no-agents` | bool | false | Exclude agent recommendations |443| `--no-mcp` | bool | false | Exclude MCP recommendations |444445---446447## Exit Codes448449| Code | Meaning |450|------|---------|451| 0 | Success |452| 1 | Failure |453| 2 | Configuration error / worker checkpoint |454| 4 | Worker escalated ambiguous failure |