octo-cliはOctoエコシステムのコマンドラインインターフェースです。薄い、 AIエージェントボット向けに設計されたシングルバイナリRESTクライアントで、exec経由で呼び出し可能です。 エージェントランタイム(OpenClaw、Claude Codeなど)から。すべての呼び出し stdoutで構造化されたJSONエンベロープを出力します。エラーはstderrに送られます。 決定論的分類法です。インタラクティブな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