mobius

Get started free
Get started free

CLI

Install and authenticate

Install the mobius CLI as a single binary, then authenticate as a person with a saved browser profile or as a machine with an API key.

Install on macOS

Install with Homebrew:

brew install deepnoodle-ai/tap/mobius

Verify the binary:

mobius version
<version>

Release archives for other platforms are available from the mobius releases. Put the binary on your PATH, then run the same version check.

Log in as a person

Browser login creates a local credential profile:

mobius auth login --default

The CLI opens a confirmation page. After approval, the terminal confirms the saved profile:

Login approved.
Saved profile: <profile-name>

Check the active identity and project:

mobius auth status
Authenticated as <email>
Organization: <organization-name>
Project: default
Profile: <profile-name>

If the shell cannot open a browser, use --no-browser. The CLI prints the URL and device code for you to confirm on another device.

Work with several profiles

List saved profiles:

mobius auth list
NAME              ORGANIZATION       PROJECT   DEFAULT
<profile-name>    <organization>     default   yes

Select one command at a time with --profile <profile-name>. To select it for the current shell, use the export command printed by:

mobius auth use <profile-name>

Authenticate a script or worker

Create a project API key in the app under Settings > Access, then expose it through the environment:

export MOBIUS_API_KEY='<project-api-key>'
export MOBIUS_PROJECT='default'

Validate a project-pinned key with a project-scoped command:

mobius loops list --project "$MOBIUS_PROJECT" --output json
{
  "items": [],
  "has_more": false
}

Do not use mobius auth status to validate a project-pinned key. That command also probes organization identity, which the key may not be allowed to read.

Pass secrets through environment variables or your CI secret store. Do not put API keys directly in scripts or shell history.

Target local development

Set the API URL on every local command, or use a dedicated profile:

mobius loops list \
  --api-url http://localhost:8080 \
  --api-key "$MOBIUS_API_KEY" \
  --project default

Next