AXI（Agent eXperience Interface）定义了一套人机工程标准，用于构建由自主智能体通过 shell 执行来交互的 CLI 工具。其核心约定如下。
输出格式：stdout 使用 TOON（Token-Oriented Object Notation），相比等价 JSON 约节省 40% token，内部逻辑仍用 JSON，仅在输出边界转换。默认 schema 尽量精简（列表通常 3-4 个字段），并提供 --fields 让智能体显式请求更多字段。
内容截断：详情视图中的大文本字段默认截断，给出预览、总长度与获取完整内容的提示（如 --full），截断上限建议 500-1500 字符。
预计算聚合：列表输出包含总数（如 30 of 847 total），并内联后端可低成本提供的派生状态摘要。
空状态与错误：明确说明零结果并表明命令成功；幂等变更在目标状态已存在时以退出码 0 返回；错误以结构化格式输出到 stdout，包含可操作建议，不泄露依赖输出；不提供交互式提示；拒绝未知标志与参数，并内联列出有效标志以便一次自我纠正。
输出通道：stdout 为结构化数据、错误与建议；stderr 为调试与进度；退出码 0 成功、1 错误、2 用法错误。
会话集成：通过显式 setup 命令注册会话钩子或插件，在会话开始时注入紧凑的目录相关上下文，默认支持 Claude Code、Codex、OpenCode；同时可提供按需加载的 Agent Skill（npx skills add <owner>/<repo> --skill <name>），SKILL.md 与无参数首页视图同源生成。
其他约定：无参数运行显示实时内容而非手册；提供上下文相关的下一步建议；每个子命令支持简洁完整的 --help；-v、-V、--version 走快速路径，仅打印版本并以 0 退出，版本号置于仅依赖 node 内置模块的叶子模块，重依赖用动态 import 延迟加载。
限制与适用：该资料为设计规范，未提供具体实现、收费或平台支持信息；实际落地需自行实现并遵循 TOON 规范。