Prerequisites
- Node.js 18 or later
- An API key from Anthropic, OpenAI, or OpenRouter
- Claude Code or another CLI-based coding agent (for the autonomous loop)
Install
Ship a feature
1
Launch wiggum
Open the interactive TUI by running
wiggum with no arguments:2
Scan your project
Run You’ll be prompted to select your AI provider and enter your API key.
/init in the TUI. Wiggum detects your tech stack and generates configuration in a .ralph/ directory.3
Create a feature spec
Run Answer 3-5 questions about your feature. Wiggum generates a detailed spec in
/new with a feature name. Wiggum starts an AI-guided interview to understand what you want to build..ralph/specs/.4
Run the autonomous loop
Run The loop runs until all tests pass or it reaches the maximum iterations.
/run with the feature name. Wiggum delegates to your coding agent and runs implement → test → fix cycles.What’s next
- Learn about interactive mode and all available TUI commands
- Configure AI providers and customize loop behavior
- Read the full command reference