kunchenguid/gh-axi

gh‑axi – 自律型AIエージェント向けGitHub CLIラッパー

何であるか

• gh‑axi は公式のGitHub CLI（gh）の上に構築されたNodeベースのコマンドラインツールです。
• AIエージェントがGitHubとプログラム的にやり取りする必要がある場合に設計されており、トークン効率の高い出力（TOONエンコーディング）、構造化されたエラーメッセージ、次のステップの提案を提供します。
• このツールは**AXI（Agent eXperience Interface）**エコシステムの一部であり、エージェントが機能を発見・利用する方法を標準化しています。

エージェントにとって重要な理由

• エージェントは大規模言語モデルを呼び出す際にトークン予算が非常に限られています。gh‑axiはCLI出力を圧縮し、エージェントが次のアクションを決定するために必要な情報のみを提示することで、LLMが処理するデータ量を削減します。
• フリー形式で人間向けの出力を行う元のgh CLIとは異なり、決定論的で機械可読の応答（JSON、簡潔なステータスコード）を提供します。
• 埋め込まれたエラー処理と検証により、曖昧なターミナルメッセージを解析する必要なく、エージェントは失敗に適切に対応できます。

主な機能

分野	gh‑axiでできること
イシューとPR	リスト表示、閲覧、作成、編集、コメント、ラベル/担当者/レビュアーの追加、ファイル（画像、動画）の添付 – 複数値に対応する繰り返し可能なフラグを備えています。
スタック	github/gh‑stack拡張機能の完全な非対話型ラッパー。スタックされたPRワークフロー（初期化、表示、送信、マージ、リベースなど）をサポートします。
ワークフローと実行	GitHub Actionsの実行をリスト表示、閲覧、トリガー、キャンセル、ログのダウンロード。ログは切り詰められますが、エージェントがgrepできるように一時ファイルに完全コピーされます。
プロジェクト（v2）	リスト表示、閲覧、作成、編集、閉じる、コピー、アイテムとフィールドの管理 – OAuthスコープが不足している場合に明確なガイダンスを提供します。
シークレットと変数	シークレットの設定（stdin専用でセキュリティを確保）、リスト表示・削除、リポジトリ全体の変数管理。
ギスト	リスト表示、閲覧、作成（公開またはシークレット）、編集、名前変更、削除、クローン。厳格なフラグ検証を備えています。
リモートAPI	gh‑axi apiで任意のGitHub RESTエンドポイントに直接アクセス。カスタムHTTPメソッド、ヘッダー、JSONボディ、ページネーション、jqフィルタリング、テンプレート、および出力切り詰めを無効にする「フル」モードをサポートします。
リポジトリと検索	標準的なリポジトリコマンド（リスト表示、閲覧、クローン、フォーク）と、イシュー、PR、コード、コミットに対する強力な検索。
セッションフック	エージェント（Claude Code、Codex、OpenCodeなど）のセッション開始時に、現在のリポジトリの状態を自動的に提示するオプションのフック。

エージェントフレンドリーな設計の詳細

• トークン効率の高いTOON出力 – LLMのコンテキストウィンドウを小さく保つコンパクトな表現。
• 構造化されたJSON – 機械可読データが必要なコマンド（例：stack view、run view）に使用。
• 繰り返し可能なフラグ（例：--add-label）により、すべての値が下位のghコマンドに正しく渡され、静かに失われるのを防ぎます。
• 検証エラーは明確です。欠落または空のフラグ値は無視されず、明確なエラーを発生させます。
• 決定論的エグジットコード – ラッパーは元のghのエグジットコードをそのまま転送し、エージェントが依存する意味論を保持します。
• 自己更新 – エージェントはgh‑axi updateを実行することで、外部パッケージマネージャーなしにツールを最新状態に保てます。

インストールと使用方法

1. エージェントスキルインストール（推奨）:

   npx skills add kunchenguid/gh-axi --skill gh-axi -g
   

   これは、最新のnpx -y gh-axiダッシュボードを指す軽量な「スキル」を登録します。
2. ゼロセットアップ – 機能のあるエージェントはnpx -y gh-axiを実行するだけでOKです。
3. グローバルインストール（手動使用用）:

   npm install -g gh-axi
   gh-axi setup hooks   # オプションのセッションフック
   

   その後、他のCLIと同様に使用可能（gh‑axi <command> …）。

エージェントの典型的なワークフロー

1. エージェントは、イシューのトリアージが必要だと判断します。
2. gh‑axi issue list --label bug --assignee @me を実行します。
3. ツールは、一致するイシューの簡潔でトークン負荷の低いリストを返します。
4. エージェントはイシューを選択し、gh‑axi issue comment 42 --body-file ./reply.md を実行します。
5. コメントに画像が含まれる場合、エージェントは--attach ./screenshot.pngを追加し、下位のghバイナリ経由でファイルをアップロードします。

ベンチマーク

• AXIベンチマーク（17の実世界のGitHubタスク、Claude‑Sonnet‑4‑6をエージェントとして使用）において、gh‑axiは100 %の成功を達成し、平均入力トークン数（約46 k）、コスト（約$0.05/タスク）、平均実行時間（約15.7秒）が、元のghおよび他のGitHub‑MCPベースのインターフェースと比較して最低でした。

誰が使うべきか

• 自律型DevOpsエージェント、AI支援コードレビュー、または信頼性が高く低オーバーヘッドのGitHub操作が必要なLLM駆動ワークフローを構築する開発者。
• すでにAXIエコシステムを使用しているチームで、GitHub操作用の即時導入スキルを求める人。

ライセンス: MIT。