octo-cli 是Octo生态系统的命令行界面——一个薄薄的， 单二进制REST客户端，专为AI代理机器人设计，通过[[T1]呼叫] 来自代理运行时（OpenClaw、Claude Code 等）。每次调用 在 stdout 上会发出结构化的 JSON 包络;错误则发送给带有 a 的 确定性分类法。没有交互式I/O。

建筑

octo-cli 是元数据驱动的。命令树在启动时自动注册 嵌入在二进制文件中的 OpenAPI 3.x 规范。添加或更改端点 这意味着编辑规范，而不是代码。

主要特性：

• 瘦客户端。 所有业务逻辑都存在于后端服务中（事项， dmworkim）。CLI负责传输、验证和格式化。
• 统一网关路由。 每个操作声明其完成 模块限定路径，并使用 OCTO_API_BASE_URL。
• 出厂DI。 internal/cmdutil.Factory 是依赖容器。 无可变包级全局;测试通过[[T4]注入存根 / CredentialFunc / ClientFunc / RegistryFunc。
• 代理优先输出。 一个稳定的 JSON 包络，包含身份、数据， 分页和速率限制元数据;一个小型固定错误分类法。

领域

octo-cli

octo-cli is the command-line interface for the Octo ecosystem — a thin, single-binary REST client designed for AI Agent Bots to call via exec from agent runtimes (OpenClaw, Claude Code, and similar). Every invocation emits a structured JSON envelope on stdout; errors go to stderr with a deterministic taxonomy. There is no interactive I/O.

Architecture

octo-cli is metadata-driven. The command tree is auto-registered at startup from OpenAPI 3.x specs embedded into the binary. Adding or changing an endpoint means editing a spec, not the code.

OpenAPI specs  ──►  Registry  ──►  Service Engine  ──►  Factory  ──►  Client  ──►  Output
(embedded)         (parsed)       (cobra commands)    (DI)          (HTTP)       (envelope)

Key properties:

• Thin client. All business logic lives in backend services (matters, dmworkim). The CLI is transport, validation, and formatting.
• Unified gateway routing. Each operation declares its complete module-qualified path and uses OCTO_API_BASE_URL.
• Factory DI. internal/cmdutil.Factory is the dependency container. No mutable package-level globals; tests inject stubs through ConfigFunc / CredentialFunc / ClientFunc / RegistryFunc.
• Agent-first output. A stable JSON envelope with identity, data, pagination, and rate-limit metadata; a small fixed error taxonomy.

Domains