Autonomous task execution and multi-phase code review. Each task runs in a fresh session, keeping Claude sharp from start to finish.
Everything you need to let Claude Code work independently on complex features
Works out of the box with sensible defaults. No configuration required to get started.
Each task executes in a new Claude session. No context degradation over long features.
Get alerted on completion or failure via Telegram, Email, Slack, Webhook, or custom script.
5 specialized agents review in parallel: quality, implementation, testing, simplification, docs.
Optional GPT-5 review for independent analysis. Two AI perspectives catch more issues.
Real-time browser UI with SSE streaming, phase navigation, and multi-session support.
Run in container for safer autonomous execution. Claude only accesses your project, not the entire system.
Create plans through dialogue with Claude. Asks clarifying questions, explores your codebase, writes structured plans.
Automatic branch creation from plan name, commits after each task, and plan completion tracking.
Four phases take your plan from idea to reviewed, committed code
Reads your plan, executes tasks one by one. Runs validation commands (tests, linters) after each task. Marks checkboxes complete and commits.
ralphex docs/plans/feature.md
Launches 5 review agents in parallel via Claude Code's Task tool. Covers quality, implementation correctness, testing, over-engineering, and documentation.
Independent review by GPT-5. Claude evaluates findings, fixes valid issues, iterates until codex reports no issues. Two AI perspectives catch more bugs.
Quality and implementation agents run one more pass focusing on critical/major issues only. Plan moves to completed/ on success.
Five specialized agents work in parallel to catch different categories of issues
Don't have a plan yet? Let Claude help you create one
Claude explores your project structure, finds existing patterns and conventions
Interactive picker (fzf) for design decisions - cache backend, auth method, etc.
Generates structured markdown with tasks, checkboxes, and validation commands
Option to start implementation right away or save for later
Adapt ralphex to your workflow, language, and review standards
Create domain-specific review agents. Add security checks for fintech, TypeScript linting for frontend, or compliance rules for regulated industries.
~/.config/ralphex/agents/*.txt
Control how tasks execute and reviews run. Modify the task prompt, first review, codex integration, or final review phases.
~/.config/ralphex/prompts/*.txt
Override global settings per repository. Each project can have its own agents, prompts, and configuration that take priority.
.ralphex/
Reference Claude Code agents you already have installed. No duplication needed - just name them in your prompts.
qa-expert, go-test-expert, ...
~/.config/ralphex/
├── config # settings (INI format)
├── prompts/
│ ├── task.txt # task execution
│ ├── review_first.txt# 5-agent review
│ ├── review_second.txt# final 2-agent review
│ └── codex.txt # external review
└── agents/
├── quality.txt # bugs, security
├── implementation.txt
├── testing.txt
├── simplification.txt
└── documentation.txtGet started in seconds