README
¶
Chief
Build big projects with Claude. Chief breaks your work into tasks and runs Claude Code in a loop until they're done.
Install
brew install minicodemonkey/chief/chief
Or via install script:
curl -fsSL https://raw.githubusercontent.com/MiniCodeMonkey/chief/refs/heads/main/install.sh | sh
Usage
# Create a new project
chief new
# Launch the TUI and press 's' to start
chief
Chief runs Claude in a Ralph Wiggum loop: each iteration starts with a fresh context window, but progress is persisted between runs. This lets Claude work through large projects without hitting context limits.
How It Works
- Describe your project as a series of tasks
- Chief runs Claude in a loop, one task at a time
- One commit per task — clean git history, easy to review
See the documentation for details.
Requirements
- Claude Code CLI, Codex CLI, or OpenCode CLI installed and authenticated
Use Claude by default, or configure Codex or OpenCode in .chief/config.yaml:
agent:
provider: opencode
cliPath: /usr/local/bin/opencode # optional
Or run with chief --agent opencode or set CHIEF_AGENT=opencode.
License
MIT
Acknowledgments
- @Simon-BEE — Multi-agent architecture and Codex CLI integration
- @tpaulshippy — OpenCode CLI support and NDJSON parser
- snarktank/ralph — The original Ralph implementation that inspired this project
- Geoffrey Huntley — For coining the "Ralph Wiggum loop" pattern
- Bubble Tea — TUI framework
- Lip Gloss — Terminal styling
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
chief
command
|
|
|
Package embed provides embedded prompt templates used by Chief.
|
Package embed provides embedded prompt templates used by Chief. |
|
internal
|
|
|
cmd
Package cmd provides CLI command implementations for Chief.
|
Package cmd provides CLI command implementations for Chief. |
|
git
Package git provides Git utility functions for Chief.
|
Package git provides Git utility functions for Chief. |
|
loop
Package loop provides the core agent loop that orchestrates Claude Code to implement user stories.
|
Package loop provides the core agent loop that orchestrates Claude Code to implement user stories. |
|
prd
Package prd provides types and utilities for working with Product Requirements Documents (PRDs).
|
Package prd provides types and utilities for working with Product Requirements Documents (PRDs). |
|
tui
Package tui provides the terminal user interface for Chief.
|
Package tui provides the terminal user interface for Chief. |
Click to show internal directories.
Click to hide internal directories.