Skip to main content
Headless mode runs wiggum commands directly without the TUI. Use this for CI pipelines, scripting, and integration with other agents like OpenClaw.

​
Commands

wiggum init                      # Scan project, configure AI
wiggum new <name>                # Create feature spec
wiggum run <name> [options]      # Run autonomous loop
wiggum monitor <name> [options]  # Monitor a running loop
wiggum config [args...]          # Manage API keys

​
When to use headless mode

  • CI/CD pipelines — run wiggum in automated workflows
  • Agent orchestration — let other AI agents invoke wiggum programmatically
  • Scripting — chain wiggum commands in shell scripts
  • Non-interactive terminals — environments without TTY support
In a TTY terminal, wiggum monitor automatically opens the TUI. Use --stream to force headless output.

​
Pass options inline

Headless mode accepts all configuration via flags instead of interactive prompts: 
wiggum init --provider anthropic --yes
wiggum new auth-flow --provider openai --model gpt-4o --force
wiggum run auth-flow --worktree --model opus --max-iterations 15 --review-mode auto
See the commands reference for all available flags.