octo-cli
专为AI Agent设计的命令行REST客户端，输出结构化JSON。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：octo-cli。 它的用途是：专为AI Agent设计的命令行REST客户端，输出结构化JSON。 完整的 Skill 内容见：https://321skill.com/skills/octo-cli/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请使用octo-cli获取当前用户所在的群组列表。”，它会执行类似 `octo-cli group list` 的命令，并将返回的JSON结构（包含群组ID、名称等信息）解析后呈现给你。或者
对AI说：“发送一条消息到线程123”，AI会调用 `octo-cli message send --thread-id 123 --content 'Hello'` 并处理返回的发送状态。
介绍
octo-cli是Octo生态系统的命令行接口，专为AI Agent Bot通过exec调用而设计。它解决了Agent运行时需要与多种后端服务（如文档、消息、文件等）进行结构化、无交互通信的痛点。
使用时，Agent只需执行相应的octo-cli命令，所有调用结果都会以稳定的JSON信封格式输出到stdout，错误信息则输出到stderr，并带有明确的分类。这使得Agent可以轻松解析和处理来自不同服务的响应。
它非常适合智能体开发者、后端开发者和运维工程师，他们需要构建或维护能够自动化调用REST API的AI Agent。对于需要在Claude Code、OpenClaw等环境中集成企业级服务能力的开发者来说，这是一个核心工具。
请注意，octo-cli本身不包含业务逻辑，所有逻辑都在后端服务中。它是一个纯粹的传输、验证和格式化工具，通过嵌入的OpenAPI规范自动生成命令树，确保了接口的准确性和一致性。
核心特点
与通用HTTP客户端（如curl）相比，octo-cli专为AI Agent集成设计，每次调用都输出Agent易于解析的稳定JSON信封，并内置了针对Octo生态9大领域（文档、消息、文件等）104个操作的预置命令和验证。其元数据驱动架构使得添加新端点只需修改OpenAPI规范，无需改动代码。
注意事项
不适合需要交互式操作或直接面向人类用户的CLI场景，也不适用于Octo生态系统之外的其他API调用。
常见问题
octo-cli和curl有什么区别？
octo-cli专为AI Agent设计，预置了Octo生态所有API命令，输出为结构化JSON信封，便于Agent解析；curl是通用HTTP工具，输出原始响应，需要额外处理。
如何添加新的API接口？
只需在对应的OpenAPI规范文件中定义新端点并添加`x-octo-base-url`标签，重新构建octo-cli即可，无需修改Go代码。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/octo-cli/raw/index.md 读取 octo-cli 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/octo-cli/raw/index.md（查看排版版本）