umputun/ralphex

何を解決するか

ralphex は、Claude Code や codex などの AI コーディングエージェントを使用して、複雑なソフトウェア実装計画を自動化するための CLI ツールです。インタラクティブエージェントの手動監視（"ベビーシッティング"）の必要性を排除し、長時間の AI セッションでコンテキストが過剰になることで生じる品質低下を防ぎます。各タスクを新規セッションで実行することで、AI モデルが鋭く、集中した状態を維持できます。

動作方法

ralphex は、Markdown形式の計画を完成コードに変換するためのマルチフェーズパイプラインをオーケストレーションします：

1. タスク実行：計画ファイルを読み込み、AIエージェントを使って未完了のタスクを1つずつ実行し、各ステップ後に検証コマンド（テストやリナーや）を実行します。
2. 初回コードレビュー：品質、実装、テスト、簡素化、ドキュメントの5つの専門エージェントを並列で起動し、問題を発見・修正します。
3. 外部レビュー：オプションで、OpenAI Codex などの外部ツールを使用して、独立したクロスモデルレビューを実施します。
4. 2回目のコードレビュー：最終段階として、2つのエージェントが重大な問題とクリティカルな問題に焦点を当て、リグレッションが発生していないか確認します。
5. 最終化：オプションのステップで、コミットをリベース・ス쿼ッシュして Git ログを整理できます。

対象ユーザー

IDEプラグインやクラウドサービスを必要とせずに、AIエージェントを使って機能実装とコードレビューを自動化したい開発者、またAI支援コーディングにおいて構造的で計画主導のアプローチを好むユーザー向けです。

特徴

• 自律的パイプライン：計画作成から最終コミットまで完全自動化。
• マルチエージェントレビュー：複数の専門エージェントとオプションのクロスモデル検証を用いた高度なパイプライン。
• ワークツリー分離：git worktrees を使用して、複数の計画を並列で実行可能。
• 柔軟なエグゼキューター：Claude Code と codex の両方を主要な実行エンジンとしてサポート。
• リアルタイムモニタリング：ストリーミング端末出力と、進捗状況を追跡可能なオプションのWebダッシュボードを提供。