Authentication - Miru

The CLI supports two ways to authenticate: an interactive login for your development machine, and an API key for non-interactive use such as CI pipelines, scripts, and AI agents. To log in, run the login command.

miru login

The CLI prints a verification URL and a short code, then opens the URL in your default browser. Confirm that the code in the browser matches the code in the terminal.

$ miru login

Visit https://app.mirurobotics.com/oauth/device?user_code=XXXX-XXXX

Confirm this code is shown in your browser: XXXX-XXXX

◐ Waiting for authentication...
Successfully authenticated as Benjamin
  Type         User
  User Type    Admin
  Auth Source  Token stored by miru login
  Workspace    Acme Robotics

API key

Instead of using the login command, you can export the MIRU_API_KEY environment variable to authenticate the CLI via API key.

export MIRU_API_KEY=<your-api-key>

No login is required when MIRU_API_KEY is set. To create an API key, follow the instructions in the API keys section. To determine which scopes the key needs, find the command you want to run in the CLI Reference and consult its API key scopes section. For using the CLI in a CI pipeline, see the CI/CD guide.

Last modified on August 27, 2026

⌘I