Skip to content
M31A
COMMAND LINE INTERFACE

The Runtime, Addressed by Name.

M31A provides a complete clap-derive CLI with machine-readable --output json options, strict UNIX exit codes, and an interactive Ratatui TUI cockpit.

Interactive Command Preview

Select commands below to inspect real documented output and environmental checks.

$m31a doctor
[i] Probing host runtime environment and platform qualifications...
OK Architecture: x86_64-unknown-linux-gnu (Release Qualified)
OK Git Worktree: Isolation available, verified clean root
OK Process Limits: POSIX rlimits supported (max_memory, cpu_time)
OK Confinement: Linux cgroups v2 hierarchy available
OK Storage: SQLite 3.46+ with WAL mode enabled
OK Provider Trust: NVIDIA NIM API reachable (integrate.api.nvidia.com)
OK Secret Redaction: 5-tier filter pipeline verified active
--> All runtime prerequisites verified. Ready for mission execution.
AUTOMATION CONTRACT

Standardized UNIX Exit Codes

Every invocation returns a predictable exit code designed for headless CI/CD evaluation runners:

exit 0Success

Mission or command finished with all verification checks satisfied.

exit 1Verification Failure

Compiler error, failing tests, or unverified diffs.

exit 2Policy Violation

Operation blocked by policy gate (fail-closed DENY).

exit 3Budget Exhaustion

Exceeded tokens, execution time, steps, or financial limits.

exit 4Crash / Unrecoverable

Process fault or panic; state preserved in SQLite.

exit 5Configuration Error

Malformed config file or invalid authority parameter.

Full Command Catalog

18 documented subcommands across 6 operational categories.

m31a / m31a tui
Core

Launch the interactive Ratatui cockpit interface.

Usage: m31a [OPTIONS] or m31a tui
m31a mission run
Mission & Task

Start an autonomous software engineering mission.

Usage: m31a mission run <PROMPT> [OPTIONS]
m31a mission list
Mission & Task

List all recorded missions in the current workspace.

Usage: m31a mission list [--all]
m31a mission show
Mission & Task

Display detailed mission status, task DAG, and budget consumption.

Usage: m31a mission show <MISSION_ID>
m31a mission pause / resume / cancel
Mission & Task

Control the lifecycle state of an active mission.

Usage: m31a mission [pause|resume|cancel] <MISSION_ID>
m31a task list / show
Mission & Task

Inspect individual tasks in the mission DAG and their verification evidence.

Usage: m31a task list <MISSION_ID> or m31a task show <TASK_ID>
m31a agent list
Inspection

Inspect active and idle agents across the 8 canonical roles.

Usage: m31a agent list
m31a capability list
Inspection

List all 15 core capability families and operational availability.

Usage: m31a capability list
m31a policy check
Inspection

Dry-run evaluate an action or tool against active policy layers.

Usage: m31a policy check <TOOL> [-m <MISSION_ID>]
m31a checkpoint list / restore
Inspection

Manage atomic two-phase mission checkpoints and rollback.

Usage: m31a checkpoint list <MISSION_ID> or m31a checkpoint restore <CHECKPOINT_ID>
m31a artifact list / show
Inspection

Inspect content-addressed immutable execution artifacts and SHA-256 digests.

Usage: m31a artifact list <MISSION_ID> or m31a artifact show <ARTIFACT_ID>
m31a doctor
Diagnostics

Run comprehensive environmental diagnostic probes.

Usage: m31a doctor [--json]
m31a telemetry inspect
Diagnostics

Inspect execution traces, hierarchical spans, metrics, and token usage.

Usage: m31a telemetry inspect <MISSION_ID> [OPTIONS]
m31a config validate / get / set / sources
Configuration

Inspect, validate, and manage hierarchical configuration across 7 tiers.

Usage: m31a config [validate|get|set|sources|explain]
m31a eval run
Diagnostics

Execute autonomous evaluation harness benchmark scenarios.

Usage: m31a eval run [--scenario <ID>|--all] [OPTIONS]
m31a init
Core

Initialize workspace onboarding state (idempotent; use --force to re-enter setup).

Usage: m31a init [--force]
m31a version / deployment
Deployment

Display deployment channel, build identity, commit hash, and artifact details.

Usage: m31a version [--verbose] or m31a deployment [--verbose]
m31a update / rollback
Deployment

Transactional binary update from manifest and atomic rollback to previous binary.

Usage: m31a update --manifest <path> [--check] or m31a rollback