orca-cli について
orca-cliは、セッションに応じたOrca実行ファイルを選び、コマンド利用前に対応するガイドを読み込むスキルです。誤った実行ファイルの使用を避け、未対応の操作を推測しない手順を示します。
主な機能
- 01セッション用実行ファイルの選択
- 02対応するCLIガイドの読み込み
- 03不明なコマンドのヘルプ確認
- 04実行エラー時の停止
活用シーン
- 01管理対象セッションでのOrca操作準備
- 02LinuxでGNOME Orcaの誤起動を回避
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ chu1pc/ chu-orca --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 で起動してから再試行してください。skills get が不明な場合は、Orca を更新するとガイドが復元されることを説明してください。読み取り専用の確認には --help を使用し、サポートされていないコマンドを推測して実行しないでください。
コメント
Markdown 対応