Skip to content
Maia OS

CLI

The maia CLI is the JSON-first public client of @maiaos/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 receipt list — bounded no-payload index; grammar in maia help receipt --json
  • 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
  • maia runtime list — blocked closed installed-harness inventory; not enabled; does not launch, select, or authorize a harness

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

maia context show is a source-implemented, release-disabled Client-principal candidate. It is not enabled product behavior.

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
  • ADR-015 maia api list | show | invoke and Session-bound maia notebook lifecycle, variable, checkpoint, handoff, and execute families; TypeScript execution additionally requires A6/W3 hard containment
  • Desktop/mobile ADE parity
  • Remote access and deployment flows
  • Inbox --scope current

Next action

Use maia help --json for the classified index, then maia help <family> --json for usage rows. 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. The complete accepted Notebook contract lives in the execution specification.