orca-cli について
orca-cli は、現在のセッションで使える Orca 実行ファイルに対応したガイドを読み込むスキルです。実行ファイルを安全に選び、コマンド実行前にガイドを確認する手順を説明します。
主な機能
- 01セッション用 Orca 実行ファイルの特定
- 02対応バージョンのコマンドラインガイドの読み込み
- 03未記載コマンドの help による確認
- 04ランタイムとアクセスエラーへの対処
活用シーン
- 01管理対象セッションで適切な Orca コマンドを特定
- 02実行前に利用可能なコマンドを確認
- 03ランタイムアクセスや起動エラーへの対処
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ phocassoftware/ phorca --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 で起動してから再試行してください。runtime_access_denied で失敗した場合は、サンドボックスによって接続がブロックされています。権限を昇格して再実行し、ORCA open の実行や Orca の再起動はしないでください。skills get が不明なコマンドの場合は、Orca を更新するとガイドが復元されることを説明してください。読み取り専用の情報を確認するには --help を使用し、サポートされていないコマンドを推測しないでください。