octo-cli는 Octo 생태계의 명령줄 인터페이스입니다 — 얇은 , AI 에이전트 봇을 통해 호출할 수 있도록 설계된 단일 바이너리 REST 클라이언트입니다. 에이전트 런타임(OpenClaw, Claude Code 등)에서 호출됩니다. 모든 호출 stdout에서 구조화된 JSON 엔벨로프를 방출합니다; error는 stderr로 전송됩니다. 결정론적 분류체계. 인터랙티브 I/O는 없습니다.

건축

octo-cli는 메타데이터 기반입니다. 명령 트리는 시작 시 자동 등록됩니다 OpenAPI 3.x 사양이 바이너리에 내장되어 있습니다. 엔드포인트 추가 또는 변경 코드를 편집하는 게 아니라 명세를 편집하는 것입니다.

주요 특성:

• 씬 클라이언트. 모든 비즈니스 로직은 백엔드 서비스에 존재합니다 (중요함, dmworkim). CLI는 전송, 검증, 포맷팅입니다.
• 통합 게이트웨이 라우팅. 각 작업이 완료됨을 선언합니다. 모듈 자격 경로와 OCTO_API_BASE_URL를 사용합니다.
• 공장 DI. internal/cmdutil.Factory는 의존 컨테이너입니다. 변경 가능한 패키지 레벨 글로벌 객체는 없습니다; 테스트는 [[T4]를 통해 스텁을 주입합니다. / CredentialFunc / ClientFunc / RegistryFunc.
• 에이전트 우선 출력. 식별 및 데이터, 페이지네이션, 그리고 속도 제한 메타데이터; 작은 고정 오류 분류법.

도메인

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