R.I.N.D.O TERMINAL / REFERENCEターミナル版 説明書

迷ったら、この3つ

書き方の約束

そもそも何をするものか

リンドウは Claude Code をそのまま動かす入れ物です。ペインの中で走っているのは無改造の claude で、 リンドウは画面を割ったり、状態を見張ったり、日本語の入口を用意したりする側に徹しています。 だからモデルの選択も思考の深さも承認の仕方も、リンドウの設定ではなくペインの中の claude が受け持ちます。

立ち上げる

rindo [作業フォルダ] [オプション]

閉じかた・抜けかた

常駐させたいときは rindo session new <名前> から始めてください。詳しくは rindo コマンドの節にあります。

スマホから続ける

導入すると、この PC で立ち上げた claude の会話が、スマホの Claude アプリにも出るようになります。 外出先から続きを打てます。ペインの中で打った claude も含めて、全部の会話が載ります。

中身は Claude Code 自身の設定 ~/.claude/settings.json の "remoteControlAtStartup": true の1行です。 リンドウの外で打つ claude にも効きます。書き換える前の設定は ~/.claude/backups/ に控えます。

3つの層

ワークスペースの中にタブがあり、タブの中にペインが並びます。ペインは全部で12枚まで。 ワークスペースは「案件・フォルダのまとまり」、タブは「作業のかたまり」、ペインは「1つの端末、または1つの読み物」です。

┌ タブ帯 ────────────────────────────────────────────────┐
│ 1:main   2:api                           ⛶  host   12:04 │
├──────────┬──────────────────────────────────────────────┤
│ 一覧      │ ┌ ペイン1 ────────┬ ペイン2 ───────────────┐ │
│ ● 考え中  │ │ claude          │ npm run dev           │ │
│ ◉ 許可待ち│ │                 ├───────────────────────┤ │
│ ○ 空き    │ │                 │ ペイン3               │ │
│ ▪ 端末    │ └─────────────────┴───────────────────────┘ │
└──────────┴──────────────────────────────────────────────┘
   ワークスペース ＞ タブ ＞ ペイン（最大12枚）

ペインの4つの顔

状態の印

左の一覧とタブ帯に出ます。設定 statusIndicators で dots（色の点）／symbols（形）／text（ことば）を選べます。

様子はふだん、ペインに出ている字から読みます。Claude Code 2.1.287 からは、ペインで立つ claude に rindo の mod（rindo-bridge）を載せ、答え始め・答え終わり・許可を訊いたところを claude 自身から受け取ります。字が読み切れないとき（狭いペイン・流れて見えなくなった枠）も、許可待ちを取りこぼしにくくなります。

• mod はペインの中の claude にだけ載ります（環境変数 CLAUDE_CODE_PLUGIN_DIRS）。~/.claude の設定も、作業フォルダの設定も書き換えません。
• 知らせが届いている間は、これまでのフック（~/.claude/settings.json の state.mjs）は黙ります。古い claude や mod が読めないときは、フックがそのまま働きます。
• 知らせの受け口は 127.0.0.1 だけで開き、ペインごとの合言葉が要ります。通すのは様子の知らせだけで、ペインを読む・打ち込む・閉じることはできません。
• 設定 claudeBridge を切ると載せません。

ペインの中のプログラムが、端末の並び OSC 7501（Program Status Protocol）で自分の様子を知らせてきたときは、画面から推し量るより先にそれを使います。 ESC ] 7501 ; state=working:id=build:progress=40 ESC \ のように送ると、作業中・返事待ち（blocked）・済み・失敗（error）・空きが一覧に出ます。 プロンプトが戻ったときとプログラムが終わったときに、作業中と返事待ちは消え、済みと失敗は人が見るまで残ります。上限を破った知らせは丸ごと捨てます。 問い合わせ（ESC ] 7501 ; ? ESC \）には、分かる様子と種類を返します。

左の一覧・タブ帯・ペインの縁

タブ

画面（ペイン）

ワークスペース

ブランチ（git worktree）

切ったブランチの置き場所は設定 worktreesDir。空なら ~/.rindo/worktrees です。

変更を見直す

切ったブランチのペインで Ctrl+B V（または /review）。元のブランチとの差が、ファイルの一覧で出ます。コミット済みも、まだコミットしていないものも、足したばかりのファイルも同じ一覧です。元の作業フォルダで開いたときは、コミットしていない変更だけを見ます。

指摘は、ペインを閉じても送るまで残ります。渡す先は、いま見ているペインがそのフォルダの端末ならそこ、でなければそのフォルダで Claude などが動いているペインです。

切ったブランチの下ごしらえ

ブランチを切ると、開く前に次のことを済ませます。

• 元の作業フォルダの .env と .env.* を写す（git に載っているもの・もうあるものは上書きしません）
• ブランチごとにポートをずらして、そのブランチで開くペインに PORT と RINDO_PORT を渡す（3000 から 10 ずつ。元の作業フォルダは 3000 のまま）
• 準備のコマンドがあれば、新しいペインで順に走らせる

案件ごとの決め方は、元の作業フォルダの .rindo/worktree.json に書きます。

{
  "copy":  [".env", ".env.*", "apps/web/.env.local"],
  "setup": ["npm install"],
  "port":  { "base": 3000, "step": 10, "env": ["PORT", "VITE_PORT"] }
}

準備のコマンドは案件の中に書かれたものなので、初めてのときと中身が変わったときだけ、走らせてよいか確かめます。ポートをずらさないなら "port": false と書きます。

• この確かめでは Enter はやめるです。走らせるときは選んでから決めてください。
• ./setup.sh のように台本を指しているときは、その台本の中身が変わったときも訊き直します。台本の中から読むほかのファイルまでは見ていません。
• 改行・タブなどの制御文字が入ったコマンドは走らせません。

issue から始める

Ctrl+B I（または /issue）で、案件の GitHub で開いている issue を並べます。選ぶと次のことを1手で済ませます。

• issue の番号と題からブランチ名を作り（例：issue-12-fix-login。その場で直せます）、ブランチを切る
• 上の下ごしらえを済ませて、エージェント（既定は claude）を立ち上げる
• 立ち上がったら、issue の題・URL・ラベル・本文を最初の依頼として渡す

番号が分かっていれば /issue 12 で一覧を飛ばせます。ペインの中からは rindo worktree create --issue 12 でも始められます（--cmd codex で相手を変えられます）。

GitHub とは gh（GitHub CLI）を通して話します。先に gh auth login を済ませてください。rindo は GitHub の鍵を持ちません。

使用量を見る

Ctrl+B U（または /usage）で、この PC の Claude Code がどれだけ使ったかを開きます。いまの枠のモデル別・案件別、今日と7日間の合計、日ごとの量が並びます。契約の上限に対する残りとリセット時刻は、Claude Code のステータスライン（rate_limits）か、Claude の設定の「使用量」で見てください。

• 数えているのは、この PC の Claude Code が書いた会話記録（~/.claude/projects）だけです。ほかの PC やブラウザで使った分は入りません。どこにも送りません。
• 契約の上限そのものは記録に無いので、「残り何%」は出しません。自分の過去の枠と比べて見てください。
• 割合は、入力を1として 書き込み1.25（1時間もつものは2）・読み戻し0.1・出力5 で重みを付けて比べています。生のトークン数は読み戻しがほとんどを占め、枠の減り方とずれるためです。
• 5時間枠は、この PC で最初に答えた時刻の「時」の頭から5時間で区切っています。Claude の実際の枠はアカウント全体で1つなので、ほかの PC や Claude のアプリで先に使っていると、区切りが何時間もずれます。正確な残りとリセット時刻は Claude の設定の「使用量」で見てください。

Claude Code のステータスライン

rindo を立ち上げると、Claude Code にまだステータスラインが無ければ、rindo の2行を置きます（~/.claude/settings.json の statusLine）。

rindo-pro [Opus 5.5 (1M context)/xhigh] main wt:fix-login p35
ctx [###-------] 32%/1M  5h 61% 1h19m  7d 12%  +120/-30  cache 98% warm 4m

• 1行目は、フォルダ・モデルと考える深さ・ブランチ・作業ツリー・ペインの名前です。ペインの名前は rindo のペインの中だけ出ます（「p35 に頼んで」と言うときに使えます）。
• 2行目は、コンテキストの使用量・契約の5時間枠と7日枠の使用率（公式の数字）・書き足した行と消した行・キャッシュの温まり具合です。枠の使用率が半分を超えると、リセットまでの残り時間も出します。50% で黄、80% で赤になります。
• 金額は API キーで払っているときだけ出します。定額の契約では API に換算した額で、実際に払う額ではないためです。
• 自分のステータスラインを置いているときは、触りません。置いたあとで消した場合も、もう足しません。

読む・写す

その他

作業中の AI をいっせいに止める（F13）

F13 を押すと、作業中の claude・codex・gemini などにいっせいに Esc を送って止め、「N 枚を止めました」と出します。前置きキーは要りません。どの画面・どのモードに居ても効きます。 ふつうのキーボードには無いキーなので、机の上の USB ボタンに F13 を割り当てておけば、非常停止のボタンになります。

• 止めるのは今の作業だけです。プロセスと会話は残るので、続きから頼み直せます。
• 送るのは作業中（●）のものだけです。許可待ち・質問・待ちのもの、手が空いているものには送りません（そこへ Esc を送ると、人に代わって断ることになるため）。
• 押しっぱなしにしても、同じペインへは 2 秒のあいだ送り直しません。
• ペインの中からは rindo agent stop-all で同じことができます（rindo agent）。
• F13 が効くのは、更新を当てたあとリンドウを立ち上げ直してからです。rindo agent stop-all は立ち上げ直さなくても使えます。

番号で跳ぶ

行き先モード（Ctrl+B g のあと）

前置きキーを打ち直さずに、続けて渡り歩けます。

大きさを変えるモード（Ctrl+B r のあと）

マウスが使えるなら、ペインの境界をそのままドラッグしても変えられます。

コピーモード（Ctrl+B [ のあと）

写したらモードを抜けます。

さかのぼれる行数は設定 termScrollback（既定 2000 行）。

端末ペインの中に居るとき

打鍵はそのまま中のプログラムへ届きます。リンドウが横取りするのは、次の5つだけです。

空きペインに居るとき

中で何も動いていないので、開くための一打だけを受けます。

読むペインに居るとき

less と同じ手つきです。

マウス

マウスをまるごと中のプログラムに任せたいときは、設定 mouseCapture を切ってください。

キーを付け替える

設定 keys に「打つキー → 割り当て名」を書くと、上の表に重なります。 割り当て名を空にすると、その打鍵は効かなくなります。

{
  "keys": {
    "s": "split_vertical",     ← Ctrl+B s で左右に割る（設定は Ctrl+B , などへ移す）
    "S": "settings",
    "q": ""                    ← Ctrl+B q（終了）を無効にする
  }
}

キーの書き方は表の1列目と同じで、1文字か tab / backtab / up / down / ctrl-z / ctrl-d / ctrl-v のような名前です。 迷ったら rindo config reset-keys で、はじめの組にまるごと戻せます。

会話・記録をあつかう

ペインをあつかう

読む・渡す

設え・道具立て

手入れ・困ったとき

早見

rindo pane — ペインの中からペインを操る

親のリンドウが名前付きの口（Windows は named pipe、mac と Linux は unix socket）を開き、 ペインごとの合言葉で子から操らせます。流れるのはペインの操作だけで、認証情報は乗せません。 口のありかは環境変数 RINDO_CONTROL で子に渡ります。設定 paneControl を切ると口ごと閉じます。

ペインで立ち上がった Claude には、この口の早見表が会話のはじめに渡ります。開発サーバを隣で走らせる・画面をブラウザで確かめる・ 別の AI に並べて頼む、といった場面では、コマンドを覚えていなくても Claude の方から使います（使ったときは一言添えます）。

# 隣に窓を開いてテストを回し、終わるまで待ってから結果を読む
rindo pane split --cmd "npm test"
rindo pane wait 2 --state 済み --timeout 600 --notify
rindo pane read 2 --lines 40

名を省いたときは、打ったペインのことになります（rindo pane zoom・rindo pane neighbor right）。

rindo pane split・pane new・agent start・browser open・edit・note で開くペインは、人がいま見ているタブではなく、打ったペインのタブに出ます。 --no-focus を付けなければ、そのタブへ移ります。--id でペインを名指ししたときは、そのペインの隣に開きます。

rindo workspace / tab — 外側を組む

操れるのは、自分と、自分が開いたペインを含むところだけです。ワークスペースは w1、タブは t1 のように書きます。

rindo agent — 相手を立ち上げる

# 隣で codex を立てて、頼んで、答え終わるまで待つ
rindo agent start --kind codex --ready
rindo agent prompt p2 "テストが落ちる原因を探して" --wait

役割の型は、立ち上げる1行と最初の指示を書いた .md です。置き場は <設定の置き場>/templates/<型>.md（rindo agent templates が出します）。 リポジトリの中の型は読みません（clone しただけの中身から、そこに書かれたコマンドが走らないように）。command の頭は --kind に書ける相手に限ります。

---
command: claude --model opus
description: 差分を見て、指摘だけを返す
---
あなたはレビュー役です。直さずに、指摘を重い順に返してください。

親と子：ペインの中から agent start で割って立てた相手は、打ったペインの子になります（agent list の parent）。 親を閉じると子も閉じます。依頼を渡したのにまだ動き出していない子は、--children all で済んだと数えません（20 秒動かなければ数えます）。

# 型で2つ立てて、両方の手が空くまで待つ
rindo agent start --template reviewer "差分を見て" --no-focus
rindo agent start --template tester "テストを足して" --no-focus
rindo agent wait --children all --timeout 900

stop-all の選び方は F13 と同じです。届くのは自分と自分が開いたペインだけで、打った自分のペインは外します。

rindo notify / worktree / status — 知らせる・切り出す・様子を見る

rindo layout — 組みを書き出す・読み込む

rindo terminal — 外の端末とつなぐ

抜けるのは Ctrl+]。--takeover を付けると、ペインの大きさをつないだ端末に合わせ、抜けると元に戻ります。 常駐しているセッションが1つなら --session は省けます。つなげるのは rindo session new で常駐させたものだけです。

rindo browser / note / edit / ex — 隣にひらく・フォルダを選ぶ

ひらく場所は、既定で左右に割った隣です。-h で上下、--tab で別のタブ。--no-focus を付けると、手元の入力を奪いません。

rindo ex は、出力を拾われているときは選んだフォルダを出すだけです。ペインの外の PowerShell なら cd (rindo ex) で同じことができます。

rindo api — 形を JSON で読む

rindo session — 常駐させる

名前は英数字と _ - だけ、32文字までです。

常駐しているものから抜けるのは Ctrl+B Ctrl+D。中の作業は動き続けます。

new・attach・stop・delete と rindo --session は、リンドウのペインの中からは使えません。 ペインの中の AI が、ほかのセッションをのぞいたり止めたりできないようにするためです。リンドウの外の端末から打ってください（list は使えます）。

セッションは、並び・会話の控えをセッションごとに持ちます（sessions/<名前>/）。 2.4 以前から使っているセッションは、2.5 で最初に立てたときだけ空の並びから始まります。

rindo plugin — 足した機能を見る

rindo doctor / update / support

rindo machine — つなぐ機械を控える

使うときは rindo --machine <名>。控えるのは行き先と名前だけで、鍵も合言葉も持ちません（つなぐのは ssh 自身です）。

rindo integration — ほかの相手の様子を一覧に出す

足すのは自分の1件だけで、ほかの項目（ログインの設定を含む）は読まずに残します。claude は何もしなくても入っています。 codex は答え終わった知らせしか出さないので、「動いている」は画面の様子から見分けます。

rindo config / completion

rindo config check の出力は、✗ が直すべきところ、？ が書き間違いの疑い、 ・ がもう効かない項目です。

設定画面の使い方

設定ファイルの場所は 置き場所の節にあります。

見た目

左の一覧

タブとペイン

マウスと閉じ方

ブラウザとエディタ

知らせ

端末との付き合い方

ブランチ・自前の割り当て・プラグイン

自分のコマンドを足す（commands）

前置きキーの1打に、好きなコマンドを割り当てられます。type は走らせ方です。

{
  "commands": [
    { "key": "T", "name": "テスト", "type": "pane",  "command": "npm test" },
    { "key": "F", "name": "整形",   "type": "shell", "command": "npm run fmt" },
    { "key": "S", "name": "検索",   "type": "input", "command": "rg --line-number" }
  ]
}

タブ帯の右に置くもの（tabBarRight）

{
  "tabBarRight": [
    { "type": "zoom" },
    { "type": "command", "command": "git branch --show-current" },
    { "type": "hostname" },
    { "type": "datetime" }
  ],
  "tabBarRightSeparator": "  |  "
}

もう効かない項目

設定ファイルに残っていても害はありませんが、「書いたのに効かない」がいちばん困るので rindo config check が名指しします。この行き先はすべて「ペインの中の claude が受け持ちます」です。

置き場所と形

<userData>/plugins/<id>/rindo-plugin.toml

rindo plugin dir で実際の場所が出ます。設定 pluginDirs に足せば、ほかのフォルダも見にいきます。 plugins: false にすると、まとめて読み込みません。

手で呼ぶ動作（[[actions]]）

出来事に合わせて走る動作（[[events]]）

書き方の例

id = "shanai-check"
name = "社内チェック"
version = "1.0.0"
min_rindo_version = "2.0.0"
platforms = ["win32", "darwin"]

[[actions]]
name = "決まりごとに合っているか見る"
command = "node ./check.js"
where = "popup"
key = "C"

[[actions]]
name = "テストを回す"
command = "npm test"
where = "pane"
split = "h"

[[events]]
on = "agent.idle"
command = "node ./notify.js"
where = "shell"

走らせる子へ渡すもの

出来事で走るときは、これに RINDO_EVENT・RINDO_EVENT_PANE・RINDO_EVENT_CWD・ RINDO_EVENT_BRANCH が加わります（環境変数の節）。

確かめかた

こちらから指定できるもの

ペインの中のツールへ渡るもの

プラグインを走らせるときに渡るもの

中で使っているもの（触らなくて構いません）

ターミナル版の置き場（userData）

その中にあるもの

そのほか

Claude Code のログインと会話の記録は、Claude Code 側の置き場にあります。リンドウは触りません。Claude Code の設定には、上のフックとステータスラインだけを足します。

まず打つもの

点検の項目（doctor --fix に渡す名前）

rindo doctor              # 全部を点検する
rindo doctor --fix cli    # Claude Code だけ入れ直す

よくあるつまずき

PC を替えるとき

書類

覚えさせる

安全

開発

学ぶ