mcpField
O
orca-cli

orca-cli

github.com/vjk7989エージェントワークフロー0296 回インストール7 週間前に更新
リポジトリ

orca-cli について

h0x-ADE が管理するワークツリー、ターミナル、自動化、埋め込みブラウザーで使う h0x CLI のスキルガイドです。コマンドを推測せず、選択した実行ファイルからバージョンに合ったガイドを取得する方法を示します。

主な機能

  1. 01セッション用の実行ファイルを特定
  2. 02バイナリに対応する CLI ガイドを取得
  3. 03h0x-ADE のワークツリーコンテキストを管理
  4. 04管理対象ターミナルの確認と操作
  5. 05自動化と埋め込みブラウザーの利用

活用シーン

  1. 01h0x-ADE 管理のワークツリーで作業
  2. 02別のエージェントへの作業引き継ぎ
  3. 03管理対象ターミナルの確認や操作
  4. 04h0x-ADE 内蔵ブラウザーの制御

インストール

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

$npx skills add https://github.com/vjk7989/h0x-ade --skill orca-cli

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

詳細

h0x CLI

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

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

このセッションで CLI を特定する

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

  • ORCA_CLI_COMMAND 環境変数が設定されている場合は、その値を使用します。h0x-ADE は、管理対象の WSL セッション用にこの変数をエクスポートします。
  • 開発用チェックアウトで、セッションに ORCA_DEV_REPO_ROOT が設定されている場合は、h0x-dev を使用します。
  • それ以外で、h0x-ADE が管理するターミナルの外にいる Linux では、h0x を使用します。その環境では、裸の orca は実行しないでください。通常、Orca の端末読み上げソフトである /usr/bin/orca に解決され、ユーザーのマシンで音声読み上げが始まります。
  • それ以外の場合は、orca を使用します。

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

選択した実行ファイルを実行できない場合は、正確なエラーを報告して終了してください。別の実行ファイルに切り替えないでください。切り替えると、別の h0x-ADE ビルドを誤って対象にする可能性があります。

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

ORCA skills get orca-cli

このコマンドは、次にコマンドを処理する正確なバイナリに対応した、バージョン一致済みの完全なガイドを出力します。ワークツリー、ハンドオフ、ターミナル、自動化、組み込みブラウザーについて、まずガイドを読み、必要なコマンドを実行してください。

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

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

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

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

その後、h0x-ADE を更新すると ORCA skills get orca-cli からバージョン一致済みの完全なガイドを取得できることをユーザーに伝えてください。これらのコマンド以外については、この古いバイナリでサポートされているか不明なコマンドの使い方を推測せず、ユーザーに確認してください。

コメント

Markdown 対応