Repolode
umputun

umputun/ralphex

Claude Codeまたはcodexを使い、Markdownの実装計画に沿って自律的に実行するスタンドアロンのGo製CLI。タスクごとに新しいセッションを使い、複数段階のコードレビューを行います。

スター
1,510
フォーク
134
未解決の Issue
4
最終コミット
4 日前

これは何?

ralphexは、Gitリポジトリのルートから実行し、Claude Codeまたはcodex CLIを制御して、実装計画を人手を介さずに進めるコマンドラインツールです。計画は、タスクと検証コマンドを記述したMarkdownファイルです。各タスクは新しいコーディングエージェントのセッションで実行されるため、計画が進んでもコンテキストを小さく保てます。タスクごとに検証コマンドを実行し、チェックボックスにチェックを付けて、変更をコミットします。

タスクの実行後、ralphexはレビューのパイプラインを実行します。複数のレビューエージェントを並列で動かし、必要に応じてcodexなどの外部レビュー用ツールを利用したうえで、対象を絞った2回目のレビューを行います。計画ファイル名からフィーチャーブランチを作成し、完了した計画を完了済みフォルダーに移動します。また、git worktreeで実行すれば、複数の計画を並列に進められます。ブラウザーダッシュボード、Dockerによる隔離、Telegram、Email、Slack、webhook、またはカスタムスクリプト経由の通知にも対応しています。

IDEプラグインやクラウドサービスは不要です。Go、Homebrew、またはリリースダウンロードから、単一のバイナリとして入手できます。

主な機能

  • 01計画内の各タスクを、新しいClaude Codeまたはcodexのセッションで実行し、タスクごとに検証します。
  • 02複数のレビューエージェントによる並列レビューと、任意の外部レビュアーを組み合わせた複数段階のレビューを実行します。
  • 03計画ファイル名からgitブランチを作成し、各タスクの完了後とレビュー修正後にコミットします。
  • 04git worktreeに対応し、1つのリポジトリで複数の計画を並列に実行できます。
  • 05--serveフラグでリアルタイムのWebダッシュボードを利用できます。
  • 06Dockerコンテナ内で実行し、自律エージェントがアクセスできる範囲を制限できます。

ユースケース

  • ターミナルを離れている間に、作成済みの計画に沿って複数タスクにまたがる機能を実装する。
  • 他のツールや手作業でralphexの外部から加えた変更を、自動コードレビューにかける。
  • 複数の独立した計画を、それぞれ別のworktreeで同時に実行する。
  • Claudeのサブスクリプションを利用できない場合に、codexだけを実行役として使う。

クイックスタート

  1. 1

    Goでralphexをインストールする

  2. 2

    docs/plans/にプランファイルを作成する

  3. 3

    プランファイルに対してralphexを実行する

    ralphex docs/plans/my-feature.md

使う前に知っておきたいこと

  • Claude Codeまたはcodexのコーディングエージェントを別途セットアップする必要があります。
  • Claudeのデフォルトモードではclaude --printを使用します。これは2026年6月15日からAnthropicの新しいAgent SDKのクレジット課金の対象となります。

収録されている特集

トピック

よくある質問

ralphex とは?
Claude Codeまたはcodexを使い、Markdownの実装計画に沿って自律的に実行するスタンドアロンのGo製CLI。タスクごとに新しいセッションを使い、複数段階のコードレビューを行います。 ralphexは、Gitリポジトリのルートから実行し、Claude Codeまたはcodex CLIを制御して、実装計画を人手を介さずに進めるコマンドラインツールです。計画は、タスクと検証コマンドを記述したMarkdownファイルです。各タスクは新しいコーディングエージェントのセッションで実行されるため、計画が進んでもコンテキストを小さく保てます。タスクごとに検証コマンドを実行し、チェックボックスにチェックを付けて、変更をコミットします。
ralphex は無料で使えますか?ライセンスは?
ralphex は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
ralphex は今もメンテナンスされていますか?
活発にメンテナンス中。ralphex の最終コミットは 2026年11月2日 です。
ralphex は何に使えますか?
ターミナルを離れている間に、作成済みの計画に沿って複数タスクにまたがる機能を実装する。 他のツールや手作業でralphexの外部から加えた変更を、自動コードレビューにかける。 複数の独立した計画を、それぞれ別のworktreeで同時に実行する。 Claudeのサブスクリプションを利用できない場合に、codexだけを実行役として使う。
ralphex のインストール方法は?
Goでralphexをインストールする docs/plans/にプランファイルを作成する プランファイルに対してralphexを実行する: ralphex docs/plans/my-feature.md
ralphex はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/umputun/ralphex

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト