CLI Reference

wiggum init

Interactively create a new plan file.

wiggum init [--plan <path>]

wiggum generate

Generate all artifacts from a plan file.

wiggum generate <plan> [OPTIONS]

wiggum check

Score the quality of a plan file before generating. Unlike validate --lint, which checks structural correctness, check scores the substance of a plan on five dimensions and produces concrete improvement suggestions. The same score is now printed at the end of wiggum generate so the quality signal lands at the moment it matters most — right after scaffolding. Pass --no-summary to suppress it.

wiggum check <plan> [--json]

The six scoring dimensions are:

Each dimension scores 0–10. The overall score is a weighted composite. Plans scoring ≥ 7 are considered healthy; wiggum check exits with a non-zero status if the plan is below this threshold.

Run check before generate to catch low-quality plans early:

wiggum check plan.toml
wiggum check plan.toml --json

wiggum validate

Validate a plan file without generating artifacts.

wiggum validate <plan> [--lint]

wiggum add-task

Add a task to an existing plan file interactively.

wiggum add-task <plan>

wiggum bootstrap

Bootstrap a plan from an existing project directory. Detects language, build system, and project structure.

wiggum bootstrap [path] [OPTIONS]

wiggum reverse

Clone a remote git repo into a tempdir and generate a plan.toml skeleton from its contents. Optionally merge a hints file (TOML for structured overrides, Markdown for freeform rules) and/or run an LLM pass to produce intelligent phases + tasks.

wiggum reverse <url> [OPTIONS]

Examples:

# Deterministic, no LLM
wiggum reverse https://github.com/foo/bar --hints hints.toml

# Scope to a monorepo subpackage
wiggum reverse https://github.com/foo/bar/tree/main/services/api --hints hints.md

# LLM-driven phase decomposition (Anthropic Claude)
ANTHROPIC_API_KEY=sk-... wiggum reverse https://github.com/foo/bar --llm anthropic

# LLM-driven (MiniMax)
MINIMAX_API_KEY=... wiggum reverse https://github.com/foo/bar --llm minimax

# Pick a specific MiniMax model
wiggum reverse https://github.com/foo/bar --llm minimax --llm-model MiniMax-M2.7-highspeed

The hints TOML supports [project], [orchestrator], and [[phase]] blocks. See reference/example-hints.toml for the full schema, and reference/example-hints.md for the Markdown variant.

When --llm is set, the deterministic skeleton is replaced by an LLM-generated phase decomposition. The LLM receives the detected language, manifest, top-level tree, README excerpt, and your hints; it returns a JSON plan that we validate and merge. The LLM pass honours any phases you declared in your hints TOML — your structure wins over the model’s.

wiggum serve

Start the MCP server for agent integration.

wiggum serve --mcp

wiggum version

Show the CLI version and embedded git SHA.

wiggum version

Output format:

wiggum <version> (<sha|unknown>)

wiggum retro

Analyse a completed PROGRESS.md and emit retrospective improvement suggestions.

wiggum retro [OPTIONS]

wiggum replan

Re-generate a single task file after a failure. Reads the current plan and any failure evidence recorded in PROGRESS.md, then re-renders the task’s .md file with augmented hints.

wiggum replan <plan> --task <slug> [--dry-run]

Failure evidence is extracted from lines in PROGRESS.md that are tagged [~] or contain “required fix”. Extracted lines are prepended as [Previous failure] hints in the regenerated task file so the subagent has full context for the retry.

wiggum patterns

Manage the local pattern store (~/.wiggum/patterns/). Patterns are reusable TOML files derived from retrospectives that can be applied as hint augmentations to future plans.

wiggum patterns <action> [OPTIONS]

list

List all saved patterns.

wiggum patterns list

save

Save a pattern from a PROGRESS.md file (or an existing retro output).

wiggum patterns save --from <progress-path> --plan <plan-path>

apply

Apply matching patterns as additional hints to a plan file. Patterns are matched by language.

wiggum patterns apply --plan <plan-path>

wiggum report

Generate a post-execution report from PROGRESS.md.

wiggum report [OPTIONS]

wiggum watch

Watch PROGRESS.md for live progress updates.

wiggum watch [OPTIONS]

When --stall-secs is non-zero, the watch display emits a ⚠ HEALTH warning next to any task that has remained [~] in-progress for longer than the threshold. The warning continues to refresh on every poll cycle until the task transitions to a terminal state.