Command reference

This reference lists the primary operator-facing commands. Run a command with --help for the exact options supported by the installed version.

Setup and health

Command	Purpose
maia setup	Run guided provider and credential setup.
maia status	Summarize installation and runtime state.
maia doctor	Diagnose dependencies, configuration, services, and governance posture.
maia secure-runtime status	Show Full automation or Restricted mode, consequences, and operating-system steps.
maia secure-runtime setup	Install rootless Podman where supported or guide the required Windows/WSL or macOS step.
maia model	Select or inspect the model provider and model.
maia tools	Configure enabled and disabled toolsets.

Chat and sessions

Command	Purpose
maia	Open the desktop dashboard or the terminal interface in a headless environment.
maia --tui	Open terminal chat explicitly.
maia --continue	Resume the latest terminal session.

Dashboard

Command	Purpose
maia dashboard	Start the local administration dashboard.
maia dashboard --no-open	Start without opening a browser.
maia dashboard --port <port>	Use a different local port.
maia dashboard --status	Report dashboard process state.
maia dashboard --stop	Stop the managed dashboard process.

Gateway and logs

Command	Purpose
maia gateway status	Inspect the gateway service.
maia gateway restart	Restart the managed gateway service.
maia logs	Read Maia logs.
maia logs --follow	Stream new runtime log entries.
maia logs audit	Read governance audit events.

Scheduled jobs

Command	Purpose
maia cron list	List scheduled jobs.
maia cron add	Create a job interactively.
maia cron run <job_id>	Run a job now.
maia cron pause <job_id>	Pause future runs.
maia cron resume <job_id>	Resume a paused job.
maia cron remove <job_id>	Remove a job.

Lifecycle

Command	Purpose
maia update --check	Check for an update.
maia update --backup	Back up state before updating.
maia uninstall	Run interactive removal.
maia uninstall --full --yes	Remove code and Maia data.