mobius

Get started free
Get started free

CLI

Mobius CLI

The mobius CLI is the terminal interface for Mobius. It handles credential profiles, request construction, output formatting, pagination, and live stream reconnection so shell workflows do not need to reproduce the HTTP protocol.

Use the CLI for operator work, local scripts, and continuous integration. Use the API or an SDK when Mobius is part of an application request path.

How commands are organized

Commands follow the product nouns:

mobius <resource> <verb> [flags]

For example:

mobius loops list --project default
mobius runs start review-every-pull-request --project default
mobius sessions list --project default

Use --help at any level to inspect the installed version:

mobius --help
mobius runs --help
mobius runs start --help

Global controls

Every API-backed command accepts these controls:

FlagPurpose
--project <handle>Select the project explicitly.
--profile <name>Use one saved login profile.
--api-key <key>Authenticate with a project or organization API key. Prefer MOBIUS_API_KEY in scripts.
--api-url <url>Target another Mobius API, including local development.
--output <format>Choose pretty, json, yaml, or tab-separated text.
--fields <list>Project a smaller field set from structured output.
--quietSuppress successful output while preserving errors.

Interactive terminals default to readable output. Pipes default to JSON. Set --output explicitly in scripts so a future display change cannot break a parser.

A common workflow

Start a loop run and capture the returned run ID:

mobius runs start review-every-pull-request \
  --project default \
  --output json
{
  "id": "<run-id>",
  "loop_handle": "review-every-pull-request",
  "status": "queued"
}

Inspect the run's events:

mobius runs list-events <run-id> \
  --project default \
  --output json
{
  "items": [
    { "sequence": 1, "type": "run.started" },
    { "sequence": 2, "type": "step.started", "step_id": "review" }
  ],
  "has_more": false
}

Pass the latest sequence back through --after-sequence when polling for newer events. Use the run page in the app when you want a live operator view.

Next