Autonomous coding agent CLI. Point it at a plan, watch it build.
npm install chiefwiggum``
░█▀▀░█░█░▀█▀░█▀▀░█▀▀░░░█░█░▀█▀░█▀▀░█▀▀░█░█░█▄█
░█░░░█▀█░░█░░█▀▀░█▀▀░░░█▄█░░█░░█░█░█░█░█░█░█░█
░▀▀▀░▀░▀░▀▀▀░▀▀▀░▀░░░░░▀░▀░▀▀▀░▀▀▀░▀▀▀░▀▀▀░▀░▀
Autonomous coding agent CLI. Point it at a plan, watch it build.
`bash`
npx chiefwiggum@latest
That's it. Now you can use chiefwiggum anywhere.
Requires: Claude Code installed and authenticated.
`bash`
cd your-project
chiefwiggum new
You'll be prompted with numbered options:
`
How would you like to set up this project?
1) From a plan file - I have a plan.md ready
2) Describe it - I'll tell you what to build
3) Existing TODO - Just start the loop with current TODO.md
Enter choice [1-3]:
`
`bash`
chiefwiggum new plans/myplan.md
Generates specs and starts building.
`bash`
chiefwiggum loopor just
chiefwiggum
Works through existing TODO.md tasks.
`bash`
chiefwiggum status
Shows project status and task progress.
1. Setup (chiefwiggum new)specs/prd.md
- Interactive Q&A or use existing plan
- Generates: , specs/technical.md, CLAUDE.md, TODO.md
2. Build Loop (chiefwiggum loop)
- Picks first unchecked task from TODO.md
- Spawns Claude to implement it
- Commits changes
- Repeats until done
3. Guardrails
- 3 consecutive failures → stops
- 5 cycles without commits → stops
- 60 minute timeout per task
After setup:
`
your-project/
├── specs/
│ ├── prd.md # Product requirements
│ └── technical.md # Technical specification
├── CLAUDE.md # Project context for AI
├── TODO.md # Task list (checkbox format)
└── plans/
└── plan.md # Your original plan (if provided)
Environment variables:
| Variable | Default | Description |
|----------|---------|-------------|
| TODO_FILE | TODO.md | Task list file |ITERATION_TIMEOUT_MINUTES
| | 60 | Max time per task |MAX_CONSECUTIVE_FAILURES
| | 3 | Failures before stopping |MAX_NO_COMMIT_CYCLES
| | 5 | Cycles without progress |COOLDOWN_SECONDS
| | 5 | Pause between tasks |
- Claude Code CLI (authenticated)
- Git
- jq
- tmux (recommended for long builds)
- Run in tmux: For long builds, use tmux so you can detachchiefwiggum new
- Review specs first: After , review generated specs before starting loop
- Watch the output: Claude streams progress so you can see what it's doing
- Check commits: Each task should produce a commit - if not, something's wrong
Loop stops with "3 consecutive failures"
- Check /tmp/chiefwiggum-iter*.log for error detailschiefwiggum
- Fix the issue, then run again
Loop stops with "No commits for 5 cycles"
- Tasks may be too vague or blocked
- Review TODO.md and make tasks more specific
jq: command not found
`bash``
brew install jq # macOS
sudo apt install jq # Ubuntu
MIT