Skip to main content

​
Browser login

Opens your browser for OAuth authentication via Clerk. After signing in, an API key is generated and saved to ~/.oanim/credentials.yaml (file permissions: 0600).

​
Token-based login

For CI/CD environments or headless use:
This verifies the key against the API and saves it to credentials. No browser required.

​
Credential resolution

When the CLI makes API calls, credentials resolve in this order: For asset generation only, there’s an additional bypass:

​
Check who you’re logged in as

Shows your email, user ID, credit balance, and account creation date.

​
Log out

Clears saved credentials from ~/.oanim/credentials.yaml.

​
Configuration

The API URL defaults to https://api.oanim.dev. Override it for self-hosted instances:
  • ANIMATE_API_URL environment variable (highest priority)
  • api_url field in ~/.oanim/config.yaml
The full resolution order: ANIMATE_API_URL env var → config.yaml → https://api.oanim.dev.