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)が示されています。
典型的なワークフロー
- AXIツールをインストールします(例:
npm install -g gh-axi)。 - LLM駆動のスクリプトまたはプロンプトで、他のシェルコマンドと同様にツールを呼び出します。
- ツールは、オプションの集計と次のステップの提案を含むTOON(コンパクトでトークン節約形式)を返します。
- エージェントは出力を解析し、次のアクションを決定するか、データをユーザーに提示できます。
はじめに
# 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
- プロジェクト
- プロジェクト