Ralph for Codex(Cralph)— Codex向け自律ワークフロー

Tool

概要

Cralph(Ralph for Codex)は、元の「Ralph」ワークフローをCodex向けに移植・アダプトした軽量シェルツールセットです。Codex CLI を用いて「自律的なループ」を回し、タスクの生成、コード出力の取り込み、コミットやプルリクエストの作成、進捗監視までをスクリプトのみで行えるようにします。必要な依存は codex CLI、jq、git、(監視時に便利な)tmux といった標準的なツール群のみで、ローカルや簡易CI環境で試すのに向いています。READMEにはインストール方法や要件が明記され、導入のハードルは低めです。

GitHub

リポジトリの統計情報

  • スター数: 3
  • フォーク数: 1
  • ウォッチャー数: 3
  • コミット数: 5
  • ファイル数: 8
  • メインの言語: Shell

主な特徴

  • Codex CLI と連携して自動的に「Codexループ」を実行するシェルスクリプト群
  • 新規プロジェクトのセットアップやPRD(要件文書)インポート用のヘルパーを提供
  • tmux を使ったモニタリングモードで進捗をリアルタイムに監視可能
  • 依存が少なく、既存のgitワークフローに組み込みやすい設計

技術的なポイント

Cralph は基本的にシェルスクリプト(bash/sh)ベースで構成され、Codex CLI の呼び出しとJSON処理に jq を利用することで、外部ライブラリへの依存を最小限に抑えています。コアとなる cralph_loop.sh はループ処理を行い、Codex へのプロンプト送信、応答のパース、生成物のファイル化、git コミットやブランチ管理、プルリク作成といった一連のステップを自動化します。cralph_import.sh はPRDや既存ドキュメントを取り込み、プロンプトやタスク定義に変換するユーティリティで、テキスト→JSON形式の橋渡しを行います。cralph_monitor.sh は tmux セッションを用いて複数のプロセスやログを並列で観測できるようにし、長時間実行のワークフローでも状況把握を容易にします。install.sh は依存チェックと必要ファイルの配置を担い、ローカル環境での迅速な導入を支援します。設計上、各スクリプトは小さく分割されており、環境変数でCodexエンドポイントやモデル、プロンプトテンプレートを切り替えられるため、別用途への流用や拡張が容易です。注意点としては、Codex CLI の認証情報やAPIキーを安全に管理する必要があること、生成結果の品質管理(テストやレビュー)を自動化外で補完することが推奨される点です。

プロジェクトの構成

主要なファイルとディレクトリ:

  • README.md: file
  • cralph_import.sh: file
  • cralph_loop.sh: file
  • cralph_monitor.sh: file
  • install.sh: file

…他 3 ファイル

まとめ

シンプルで導入しやすい、Codexを使った自律ループの実験向けツール群。

リポジトリ情報:

READMEの抜粋:

Cralph

This project is inspired by and adapted from the original “Ralph” workflow in ralph-claude-code. Full credit and thanks to the original work: https://github.com/frankbria/ralph-claude-code

Shell tools to run the “Cralph” autonomous Codex loop (which is Ralph for codex), plus helpers to set up new projects, import PRDs, and monitor progress.

Requirements

  • Codex CLI (codex) in your PATH
  • jq
  • git
  • tmux (optional, for --monitor mode)

Install

./install.sh...