yb harness
yb harness は、ツールの設定に API キーを書き込まずに、ローカルのクライアントツールをゲートウェイへ接続します。
| コマンド | 効果 |
|---|---|
yb harness list | ツール、サポート状況、インストール、設定パス、接続済みまたはドリフト |
yb harness connect <tool> | 計画、差分、それから適用します。--yes は確認プロンプトをスキップします。--yes のない非 TTY では何も変更しません |
yb harness disconnect <tool> | 最後に適用した編集を元に戻します |
yb harness status | 適用済みトランザクションとドリフト |
yb harness doctor <tool> | 設定とゲートウェイを確認します。キーは表示されません |
yb harness key --tool <tool> | apiKeyHelper または auth.command 向けのキーを表示します |
Codex、Claude Code、OpenCode、Continue、Aider、シェルは、管理ブロックの内側で編集されます。
# >>> yabanin:<tool>:<block> (managed by `yb harness`; undo: `yb harness disconnect <tool>`) >>>
# <<< yabanin:<tool>:<block> <<<
競合する最上位の Codex 行は # yabanin-disabled: としてコメント化され、切断時に復元されます。Continue と Aider には --experimental が必要です。Cursor、Cline、Roo、Kilo、Zed、JetBrains、Copilot、Gemini CLI は理由付きで一覧に載りますが、編集されません。
キーは、ヘルパーコマンド、または {env:YABANIN_API_KEY} のような環境変数参照です。
~/.yabanin/harness 配下のバックアップのモードは 0600 です。
セッションキー
yb harness connect <tool> --session [--session-ttl 8h] は、~/.yabanin/config.json に harness.<tool>.session を保存します。その後、yb harness key --tool <tool> は ybs_ キーを発行します。そのラベルは、プロファイルの静的ラベル、ヘルパーの作業ディレクトリの git チェックアウト、および .yabanin.yml です。キーは、期限の 10 分前まで ~/.yabanin/sessions(0700、ファイルは 0600)にキャッシュされます。発行に失敗すると、ツールが動き続けられるように、親キーと警告を stderr に出力します。yb logout はセッションキャッシュを削除します。yb ci finish が実行されない場合、キー は TTL で失効します。
Claude Code はヘルパーを 5 分間キャッシュします(CLAUDE_CODE_API_KEY_HELPER_TTL_MS)。Codex は refresh_interval_ms(5 分)で更新します。したがって、ブランチの変更はその遅延の後にしか見えません。ラベルは、ヘルパープロセスの作業ディレクトリで計算されます。インストール済みの Claude Code と Codex のヘルパーに対する確認は、この変更では実行していません。キャッシュキーにはエンコードされたラベル集合が含まれるため、異なるブランチは異なるファイルになります。