orca-cli について
orca-cli は、セッションで選んだ Orca 実行ファイルに対応するガイドを読み込むためのスキルです。実行ファイルの選択と再利用の規則を示し、コマンドの詳細はガイドとヘルプに委ねます。
主な機能
- 01セッション用の実行ファイルを選択
- 02以降のコマンドで同じ実行ファイルを使用
- 03対応バージョンのガイドを先に取得
- 04未記載のコマンドやフラグはヘルプで確認
活用シーン
- 01使用する Orca 実行ファイルの特定
- 02現行バージョンのコマンドガイドの取得
- 03未知のコマンドを推測せずに対処
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ ladderchaos/ orca-backend --skill orca-cliインストール後、Claude Code で/orca-cliを入力して読み込まれたか確認します。
詳細
Orca CLI
このディスカバリースタブは、このセッションで使用されている Orca 実行ファイルから、バージョンに一致するガイドを読み込みます。
このセッションで使用する CLI を決定する
実行ファイルを一度選択し、以降のすべてのコマンドで同じものを使用します。
ORCA_CLI_COMMAND環境変数が設定されている場合は、その値を使用します。Orca は、管理対象の WSL セッションでこの値をエクスポートします。- 開発用チェックアウトで、セッションに
ORCA_DEV_REPO_ROOTが公開されている場合は、orca-devを使用します。 - それ以外で、Orca 管理のターミナル外の Linux を使用している場合は、
orca-ideを使用します。そこで裸のorcaを実行しないでください。Orca のターミナル外では、通常 GNOME Orca スクリーンリーダー(/usr/bin/orca)に解決され、ユーザーのマシンで音声が開始されます。 - それ以外の場合は、
orcaを使用します。
以下では、ORCA は選択した実行ファイルを示すプレースホルダーです。何かを実行する前に置き換えてください。シェル変数を作成したり、文字どおり ORCA を実行したりしないでください。この方法は、POSIX シェル、PowerShell、cmd.exe で同様に機能します。
選択した実行ファイルを実行できない場合は、エラーを正確に報告して停止してください。別の実行ファイルに切り替えないでください。別の Orca ビルドを誤って対象にする可能性があります。
Orca コマンドを実行する前に、バージョンに一致するガイドを読み込む
ORCA skills get orca-cli
--json を優先してください。ガイドに記載されていないコマンドやフラグについては、選択した実行ファイルの --help を使用してください。コマンドで Orca が実行されていないと報告された場合は、ORCA open --json でバックエンドを起動してから再試行してください。このフォークは Electron やデスクトップウィンドウを起動せずに開始します。runtime_access_denied で失敗した場合は、サンドボックスによって接続がブロックされています。権限を昇格して再実行し、ORCA open を実行したり Orca を再起動したりしないでください。skills get が不明なコマンドの場合は、Orca を更新するとガイドが利用できるようになることを説明してください。読み取り専用の情報確認には --help を使用し、未対応のコマンドを推測しないでください。