octo-cli — это командный интерфейс для экосистемы Octo — тонкая, один двоичный REST-клиент, предназначенный для AI Agent Bots для вызова через exec из Agent Runtime (OpenClaw, Claude Code и подобные). Каждая инвокация излучает структурированную JSON-огибающую на stdout; ошибки попадают в stderr с детерминированная таксономия. Нет интерактивного ввода-вывода.

Архитектура

Octo-CLI управляется метаданными. Командное дерево автоматически регистрируется при запуске из спецификаций OpenAPI 3.x, встроенных в бинарный файл. Добавление или изменение конечной точки Это значит редактировать спецификацию, а не код.

Ключевые свойства:

• Тонкий клиент. Вся бизнес-логика живёт в бэкенд-сервисах (имеет значение, dmworkim). CLI — это транспортировка, валидация и форматирование.
• Унифицированная маршрутизация шлюза. Каждая операция объявляет свою завершённость модульно-квалифицированный путь и использует OCTO_API_BASE_URL.
• Заводской DI. internal/cmdutil.Factory — это контейнер зависимостей. Нет мутируемых глобальных данных на уровне пакета; тесты вводят заглушки через ConfigFunc / 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