CLI

The maia CLI is the JSON-first public client of @maia/sdk. It is the first qualification harness for every later ADE surface. It is not a node, database client, or runtime supervisor.

Source-implemented candidate — callable current evidence

These commands are in the current source registry and are source-callable current evidence. They are not implemented under the release-gated AGENTS meaning and are not product enablement:

• maia help / maia --help
• maia status
• maia version / maia --version
• maia project add | list | show
• maia workspace list | show
• maia workspace repo add
• maia receipt show
• maia runtime probe codex
• maia session create | list | show | events

maia status is read/probe-only in desktop-managed mode. runtime probe codex does not copy credentials or start a model turn. Windows returns platform_unsupported for that probe until process-tree ownership is proven.

Source-implemented candidate — blocked

These exist in source and remain blocked. They are not enabled:

• maia session start — blocked Codex activation
• turn send / turn show — ordinary routing rejects the family
• macOS live-terminal create/list/show/events/read, controller request/show/acquire/release, input write, resize/signal/close
• local-v1 maia run orchestration subset

Unavailable or inert terminal surfaces include observer attach/check/detach/resync, controller renew, restart, delete, and reconcile.

Planned

Not present as enabled product behavior:

• Git-worktree create/remove
• Structured session attachments, approvals, steering, interruption
• Skills, Teammates, Rooms, Routines, Runtime Extensions, Activity
• Skill bundle recommendation, install, or sync
• Desktop/mobile ADE parity
• maia context show
• Remote access and deployment flows

Next action

Use maia help --json on the built executable. Then read the CLI README, the CLI guide, and the CLI roadmap. Foundation notes live on Node, Protocol, and SDK. Product names live on Product Surfaces.