Limai Docs
CLI Reference

auth

Authentication management for the LimAI CLI

$limai auth <subcommand>

Manage CLI authentication credentials. Store, verify, and clear API tokens.

Options
--jsonOutput raw JSON
--verboseEnable debug logging

Subcommands

limai auth login

Authenticates against https://app.limai.io and stores your credentials locally at ~/.limai/config.json.

limai auth login

You can authenticate three ways:

  1. Browser login (default) — opens your browser and completes automatically.
  2. Browser on another device — for terminals without a browser (SSH sessions, containers). The CLI prints a URL to open anywhere; after authorizing, paste the code shown in the browser back into the terminal.
  3. Manual token — paste an existing API token (input is hidden).

To authenticate against a different instance, set the LIMAI_API_URL environment variable or pass --api-url:

LIMAI_API_URL=https://app.staging.limai.io limai auth login

limai auth logout

Clears all stored credentials.

limai auth logout

limai auth status

Verifies that stored credentials are valid by making a health check request to the API.

limai auth status

Examples

Login and verify

limai auth login
limai auth status

Check status with JSON output

limai auth status --json

Clear credentials

limai auth logout

On this page