はじめ方

必要なもの

• Node.js （npm 経由でインストールする場合）
• ターミナルエミュレータ（Windows Terminal、iTerm2 など）
• Windows の場合: Git for Windows （Git Bash が含まれます。cd 追従のため推奨）
• Claude Code  と/または Codex（任意。でもこれが目的）

ソースからビルドする場合のみ Rust ツールチェーン  が必要です。

インストール

npm 経由（推奨）

npm install -g @suisya-systems/renga

Node.js が必要です。インストール後、どこからでも renga コマンドで起動できます。

Claude Code や Codex のペイン同士の会話、client 内からのペイン操作を使いたい場合は、renga の MCP サーバを client ごとに一度登録してください。

renga mcp install --client claude
renga mcp install --client codex   # Codex peer も使う場合

これで選択した client 内から、組み込みの renga-peers network と list_panes / spawn_claude_pane / spawn_codex_pane / inspect_pane / send_keys などのペイン制御ツールが使えるようになります。

バイナリをダウンロード

Releases  から最新バイナリをダウンロード：

ソースからビルド

git clone https://github.com/suisya-systems/renga.git
cd renga
cargo build --release

バイナリは target/release/renga（Windows は renga.exe）に生成されます。

初回起動

renga

シェルが起動したターミナルペイン、左にファイルツリーサイドバー、下にステータスバーが表示されます。

基本ワークフロー

1. peer 対応で Claude Code / Codex を起動

ターミナルペインで Alt+P を押します。renga が peer 対応済みの Claude 起動コマンドを自動で入力するので、内容を確認して必要なら引数を足し、そのまま Enter で起動します。

CLI から起動する場合は renga split --role claude / renga new-tab --role claude でも同じ peer 配線付きで新ペインに Claude Code が立ち上がります。

Claude Code が起動すると、ペインの枠がオレンジに変わります。

Codex ワーカーを使いたい場合は、先に renga mcp install --client codex を済ませたうえで、ペイン内で plain codex を起動するか、オーケストレータに spawn_codex_pane を呼ばせます。

2. ペインを分割

Ctrl+D で縦分割、Ctrl+E で横分割。新しいペインにはそれぞれ独立したシェルが起動します。

2 つ目の Claude ワーカーも、手で claude を打つ代わりに新ペインで Alt+P を使うのが安全です。同じ renga-peers ネットワークに最初から参加できます。

3. ファイルを閲覧

Ctrl+F でファイルツリーにフォーカス。j/k で移動し、Enter でシンタックスハイライト付きプレビューを開きます。

4. ペイン間を移動

Ctrl+→ / Ctrl+← でサイドバー、プレビュー、ペインを順に切替。またはマウスクリック。

5. Claude に他ペインを操作させる

MCP サーバを登録した client のペインは list_peers / send_message / list_panes / spawn_claude_pane / spawn_codex_pane / inspect_pane / send_keys / poll_events などを呼べます。Claude は <channel> で push 受信し、Codex は check_messages で pull 受信します。これが renga の中核で、1 つのエージェントがワーカー起動、画面確認、対話プロンプト応答まで会話の中で完結できます。

詳しくは Claude Code と Codex ペイン間のメッセージング を参照してください。

6. 終了

Ctrl+Q で renga を終了。全シェルがクリーンに終了します。

シェルの自動検出

renga は自動的にシェルを検出します：