mcpField
O
orca-cli

orca-cli

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

orca-cli について

Orca CLI は、worktree、ターミナル、自動化、内蔵ブラウザーなど、Orca のエディターやランタイムの状態を扱うエージェント向けの案内スキルです。古いコマンド情報に頼らず、実行中のバイナリに対応するガイドを先に読み込むよう案内します。

主な機能

  1. 01セッション用 CLI 実行ファイルの特定
  2. 02バージョン対応のコマンドガイドの読み込み
  3. 03worktree とターミナルのワークフロー対応
  4. 04引き継ぎと自動化の案内
  5. 05Orca 内蔵ブラウザーの操作案内
  6. 06エージェント向け JSON コマンドの指針

活用シーン

  1. 01Orca 管理下の worktree の確認や操作
  2. 02Orca のターミナルの読み取りや制御
  3. 03別のエージェントへの作業引き継ぎ
  4. 04Orca 内蔵ブラウザーの操作

インストール

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

$npx skills add https://github.com/maczzinatui/borca --skill orca-cli

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

詳細

Orca CLI

このファイルは検出用のスタブであり、使用ガイドではありません。バージョンに一致した Orca CLI の完全なリファレンスは、orca バイナリ自体から提供されます。実際にコマンドを実行するバイナリとの食い違いが決して生じないよう、意図的にこのファイルには含めていません。

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

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

実行ファイルを一度選び、その後のすべてのコマンドで同じものを使用してください。

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

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

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

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

ORCA skills get orca-cli

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

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

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

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

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

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

コメント

Markdown 対応