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

Commands

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 and wiggum agent automatically open the TUI. Use --stream to force headless output.

Common headless workflows

Generate spec from GitHub issue

The --auto flag skips the interactive interview and generates a spec directly from the goals and issue context.

Run a Ralph loop with auto-merge

Process GitHub backlog in CI

Full pipeline in one script

Pass options inline

Headless mode accepts all configuration via flags instead of interactive prompts:
See the commands reference for all available flags.