Request demo

Account and Authentication

Before running any model commands, log in to your XReduce account. Credentials are stored locally in ~/.xreduce/credentials and used automatically by subsequent commands.

Create an account

XReduce is currently in private access. for an account and an API key.

xreduce login

Interactive login prompts for your email and password and stores the returned API key locally:

$ xreduce login
Email: you@company.com
Password: ************
✓ Logged in as you@company.com (account a1b2****, key xr-****-****-9f2c)
  Credentials stored at ~/.xreduce/credentials

If you already have an API key, skip the email/password flow and pass it directly:

xreduce login --api-key xr-1234-5678-9abc

Flags

Flag	Description
`--api-key`	Skip the interactive prompt and use an existing API key directly. Useful for CI and automation.
`--email`	Provide the email up front; password is still prompted interactively.
`--profile`	Name to store credentials under. Defaults to `default`. Use multiple profiles to switch between accounts.
`--api-base`	Override the API base URL. Defaults to production. Used for staging or local dev.
`--force`	Overwrite existing credentials for this profile without prompting.

Using the Claude Skill? The Skill handles the interactive login handoff for you and resumes the workflow when you return.

xreduce logout

Removes stored credentials. By default, only the default profile is removed.

# Log out of the default profile
xreduce logout

# Log out of a specific profile
xreduce logout --profile staging

# Remove all stored profiles
xreduce logout --all

Multiple profiles

Profiles let you keep credentials for multiple accounts on the same machine. Set XREDUCE_PROFILE in the environment to pick a default for the shell, or pass --profile on individual commands:

xreduce login --profile staging --api-base https://staging.api.xreduce.ai
xreduce model list --profile staging

# Or set for the whole shell session:
export XREDUCE_PROFILE=staging

Where credentials live

~/.xreduce/credentials is a YAML file keyed by profile name. It contains your API key, account ID, and the API base URL. Treat it like any other credential file - don't commit it, and revoke the key in the XReduce dashboard if it leaks.