kunchenguid/axi

Design principles for agent ergonomics. Higher accuracy with lower token cost than both MCP and regular CLI.

AXI – Agent eXperience Interface

概要 – AXIは、人間ではなくAIエージェント向けに構築された設計フレームワークと具体的なコマンドラインツールのセットです。トークン効率的な出力、最小限のスキーマ、明示的な空状態など、10の「エージェント人間工学的」原則を定義し、これらのルールに従うAXIラップCLI(GitHub、Chrome DevTools、AWS、Docker、Notionなど)のカタログを提供します。

重要性 – 大規模言語モデルエージェントは、外部サービスを呼び出す際に厳格なトークン予算を持っています。従来のCLIやツールプロトコル(例:MCP)は冗長で、対話型プロンプトを必要とし、不要なJSONフィールドでトークンを浪費します。AXIの原則は、データを小さく、決定的にし、LLMが解析しやすくすることで、コストと遅延を削減し、信頼性を向上させます。

主要コンポーネント

  • 10の設計原則 – トークン効率的なTOON形式、最小限のデフォルトスキーマ、明示的な空の結果、構造化エラー、環境コンテキスト、コンテンツ優先のデフォルトなど。
  • AXIカタログ – 既製のAXIツールの厳選リスト。公式例は次のとおりです:
    • gh-axi – GitHub CLIのトークン効率的なラッパー。
    • chrome-devtools-axi – Chrome DevTools MCPによるブラウザ自動化。
    • lavish-axi、quota-axi、およびAndroid、npm、SQLite、Slack、AWS、Dockerなどのための多くのコミュニティ貢献AXI。
  • ベンチマーク – READMEには、AXIラップツールが標準CLIやMCPベースのアプローチと比較して、成功率が高く、コストが低く、ターン数が少なく、実行時間が速いという実証結果(Claude Sonnet 4.6)が示されています。

典型的なワークフロー

  1. AXIツールをインストールします(例:npm install -g gh-axi)。
  2. LLM駆動のスクリプトまたはプロンプトで、他のシェルコマンドと同様にツールを呼び出します。
  3. ツールは、オプションの集計と次のステップの提案を含むTOON(コンパクトでトークン節約形式)を返します。
  4. エージェントは出力を解析し、次のアクションを決定するか、データをユーザーに提示できます。

はじめに

# 2つの主要AXIをインストール
npm install -g gh-axi
npm install -g chrome-devtools-axi

# LLMプロンプトからの使用例
`gh-axi issue list --repo owner/repo --state open` を使用してオープンな問題を取得します。
`chrome-devtools-axi navigate https://example.com` を使用してヘッドレスブラウザを駆動します。

モデルがそれらの存在を知るように、ツールをエージェントのナレッジベース(例:CLAUDE.md または AGENTS.md)に追加します。

誰が使うべきか

  • SaaS API、クラウドサービス、またはローカルツールと対話する自律エージェントを構築する開発者。
  • トークン消費を削減し、ツール呼び出しの信頼性を向上させたいプロンプトエンジニア。
  • LLMが現実世界のアクションを実行するための標準化された低オーバーヘッドな方法に興味がある人。

詳細情報

  • プロジェクトウェブサイト:https://axi.md
  • ディスカッションとサポートのためのDiscordコミュニティ。
  • リポジトリ内の principles.yaml および catalog.yaml ファイルには、完全な仕様と成長するAXIリストが詳述されています。

上記のすべての情報はリポジトリのREADMEから直接取得されています。追加の機能は推測されていません。

関連

  • プロジェクト
  • プロジェクト
  • Dispatch
  • プロジェクト
  • プロジェクト