Skip to content
EximAgent Docs

Authenticate

Sign in with the OAuth device flow or a personal access token, verify with whoami, and switch between accounts with profiles.

Authentication is a one-time browser sign-in. There are no API keys to copy between machines.

Sign in

eximagent login

This opens your browser with a device code to approve. Once approved, the CLI stores the credential locally and every later command picks it up.

Sign in without a browser

On a headless box, or inside an agent sandbox, use a personal access token:

eximagent login --token <PAT>

Confirm who you are

eximagent whoami

A successful response confirms the credential is live. Run this first whenever a command fails unexpectedly — an expired session looks like a broken command.

Ground yourself in the operator profile

Your profile holds the defaults that shape later results: product, target markets, signature, incoterm, and timezone.

eximagent profile get

If it comes back {exists: false, profile: null}, nothing is grounded yet and commands will need those details spelled out each time. Filling the profile in once is the highest-leverage minute you can spend.

Multiple accounts

Saved accounts are switched per command with --profile, or for a whole shell session with an environment variable:

eximagent --profile client-a whoami
EXIMAGENT_PROFILE=client-a eximagent whoami

Next

Continue to your first result.