メインコンテンツまでスキップ

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 のヘルパーに対する確認は、この変更では実行していません。キャッシュキーにはエンコードされたラベル集合が含まれるため、異なるブランチは異なるファイルになります。