ralphex

<p align="center"> <img src="assets/ralphex-wordmark-split.png" alt="ralphex" width="400"> </p> <p align="center"> <a href="https://github.com/umputun/ralphex/actions/workflows/ci.yml"><img src="https://github.com/umputun/ralphex/actions/workflows/ci.yml/badge.svg" alt="build"></a> <a href="https://codecov.io/gh/umputun/ralphex"><img src="https://codecov.io/gh/umputun/ralphex/graph/badge.svg?token=5AH7YL5PSG" alt="codecov"></a> <a href="https://goreportcard.com/report/github.com/umputun/ralphex"><img src="https://goreportcard.com/badge/github.com/umputun/ralphex?v=2" alt="Go Report Card"></a> </p> <h2 align="center">Autonomous plan execution with Claude Code</h2>

ralphex is a standalone CLI tool that runs in your terminal from the root of a git repository. It orchestrates Claude Code to execute implementation plans autonomously - no IDE plugins or cloud services required, just Claude Code and a single binary.

Claude Code is powerful but interactive - it requires you to watch, approve, and guide each step. For complex features spanning multiple tasks, this means hours of babysitting. Worse, as context fills up during long sessions, the model's quality degrades - it starts making mistakes, forgetting earlier decisions, and producing worse code.

ralphex solves both problems. Each task executes in a fresh Claude Code session with minimal context, keeping the model sharp throughout the entire plan. Write a plan with tasks and validation commands, start ralphex, and walk away. Come back to find your feature implemented, reviewed, and committed - or check the progress log to see what it's doing.

<details markdown> <summary>Task Execution Screenshot</summary>

</details> <details markdown> <summary>Review Mode Screenshot</summary>

</details> <details markdown> <summary>Web Dashboard Screenshot</summary>

</details>