mcpField
O
orca-cli

orca-cli

github.com/fxylabsエージェントワークフロー182 回インストール
リポジトリ

orca-cli について

orca-cli は、Supervibe が管理するワークツリー、ターミナル、自動化、内蔵ブラウザーを扱うエージェント向けのコマンドラインスキルです。利用中のバイナリからバージョンに合ったガイドを取得し、古い情報に頼らない手順を示します。

主な機能

  1. 01セッション用 CLI の選択
  2. 02バージョン対応ガイドの取得
  3. 03Supervibe の状態確認
  4. 04JSON 出力の優先
  5. 05旧バージョン向けの限定的な読み取り手順

活用シーン

  1. 01Supervibe 管理下のワークツリーの確認
  2. 02Supervibe ターミナルの読み取りや操作
  3. 03自動化とエージェント間の引き継ぎ
  4. 04アプリ内ブラウザーの操作

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/fxylabs/supervibe --skill orca-cli

インストール後、Claude Code で/orca-cliを入力して読み込まれたか確認します。

詳細

Supervibe CLI

このファイルは、使い方ガイドではなく、情報を見つけるための簡易案内です。バージョンに一致した Supervibe CLI の完全なリファレンスは、orca バイナリ自体から提供されます。実際にコマンドを実行するバイナリとの間に食い違いが生じないよう、意図的にこのファイルには含めていません。

実行中のエディター／ランタイムが信頼できる情報源となる場合は、いつでも Supervibe を利用してください。対象は、Supervibe が管理するワークツリー、フォルダーコンテキスト、ターミナル、リポジトリ、自動化、ワークツリーのコメント、Supervibe アプリに組み込まれたブラウザーです。該当する例として、「$orca-cli」「Supervibe worktree」「child worktree」「spawn codex/claude in a worktree」「read/wait/send Supervibe terminal」「full handoff」／「handover」／「give this to another agent」「control the browser inside Supervibe」などがあります。Supervibe の状態が関係しない場合は、通常のシェルツールを使用してください。

このセッションで使用する CLI を解決する

実行ファイルを一度選択し、以降のすべてのコマンドで再利用してください。

  • ORCA_CLI_COMMAND 環境変数が設定されている場合は、その値を使用します。Supervibe は、管理対象の WSL セッション用にこの値をエクスポートします。
  • 開発用チェックアウトで、セッションに ORCA_DEV_REPO_ROOT が公開されている場合は、orca-dev を使用します。
  • それ以外で Supervibe が管理するターミナルの外にいる Linux では、orca-ide を使用します。その環境で orca を直接実行してはいけません。Supervibe のターミナル外では通常、GNOME Orca スクリーンリーダー（/usr/bin/orca）が解決され、ユーザーのマシンで音声読み上げが開始されるためです。
  • それ以外の場合は、orca を使用します。

以下では、ORCA は解決した実行ファイルを表すプレースホルダーです。実行前に置き換えてください。シェル変数を作成したり、ORCA をそのまま実行したりしないでください。この方法は、POSIX シェル、PowerShell、cmd.exe で同じように使えます。

選択した実行ファイルを実行できない場合は、エラーを正確に報告して停止してください。別の実行ファイルに切り替えてはいけません。そうすると、別の Supervibe ビルドが気付かないうちに対象となる可能性があります。

Supervibe のコマンドを実行する前に、完全なガイドを読み込む

ORCA skills get orca-cli

これにより、次のコマンドを処理する正確なバイナリに対応した、バージョン一致の完全なガイドが表示されます。対象には、ワークツリー、引き継ぎ、ターミナル、自動化、組み込みブラウザーが含まれます。まずガイドを読み、その後、必要なコマンドを実行してください。

記憶や、この簡易案内のキャッシュコピーを頼りに、サブコマンドやフラグを推測しないでください。Supervibe のリリースによって変更されるため、このファイルからは意図的に削除されています。ORCA status --json でアプリが起動していることを確認してください（必要に応じて ORCA open --json で起動します）。エージェントから呼び出す場合は、--json を優先してください。

古い Supervibe が skills get を認識しない場合

このフォールバックは、選択したバイナリが skills get を不明なコマンドだと明示的に報告した場合に限り使用してください。それ以外のエラーは、バイナリが古いことの証明にはなりません。推測したり実行ファイルを変更したりせず、そのエラーを報告してください。ガイド導入前のバイナリであることが確認できた場合は、状況を把握するために、読み取り専用で範囲を限定した次の手順だけを使用してください。行き詰まったり、コマンドを作り出したりしないでください。

ORCA status --json
ORCA worktree ps --json
ORCA terminal list --json

その後、Supervibe を更新すれば、ORCA skills get orca-cli からバージョンに一致した完全なガイドを利用できることをユーザーに伝えてください。これらのコマンド以外については、この古いバイナリがサポートしていない可能性のあるコマンド体系を推測せず、ユーザーに確認してください。

コメント

Markdown 対応