Skip to main content

​
AI providers

Wiggum requires an API key from one of these providers:
Set your Anthropic API key:
export ANTHROPIC_API_KEY=sk-ant-...
Or use the config command:
wiggum config set anthropic <your-api-key>
Anthropic is the default provider. Models: opus, sonnet.
API keys are stored in .ralph/.env.local and never leave your machine.

​
Optional services

These services enhance wiggum’s analysis during the scan phase:
ServiceVariablePurpose
TavilyTAVILY_API_KEYWeb search for current best practices
Context7CONTEXT7_API_KEYUp-to-date documentation lookup

​
Generated files

Running wiggum init creates a .ralph/ directory with project-specific configuration: 
.ralph/
├── ralph.config.cjs          # Stack detection + loop config
├── prompts/
│   ├── PROMPT.md             # Implementation prompt
│   ├── PROMPT_feature.md     # Feature planning
│   ├── PROMPT_e2e.md         # E2E testing
│   └── PROMPT_verify.md      # Verification
├── guides/
│   ├── AGENTS.md             # Agent instructions
│   ├── FRONTEND.md           # Frontend patterns
│   ├── SECURITY.md           # Security guidelines
│   └── PERFORMANCE.md        # Performance patterns
├── scripts/
│   └── feature-loop.sh       # Main loop script
├── specs/
│   └── _example.md           # Example spec template
└── LEARNINGS.md              # Accumulated project learnings

​
Loop configuration

The ralph.config.cjs file controls loop behavior. Key options:
OptionDefaultDescription
loop.maxIterations10Maximum implement-test-fix cycles
loop.maxE2eAttempts5Maximum E2E test retries
loop.defaultModelsonnetDefault AI model for the loop
Override these per-run with CLI flags: 
wiggum run my-feature --max-iterations 20 --model opus