reoclo profile

A profile bundles an API URL, an API key, and metadata for one tenant. Profiles let you switch between staging and production, or between multiple tenants you have access to.

Subcommands

reoclo profile ls
reoclo profile current
reoclo profile use <name>
reoclo profile rm  <name>

`ls`

Lists every configured profile, active one first, marked with *. The AUTH column says which credential the profile holds. An oauth (expired) profile still works: the next command refreshes the token for you.

$ reoclo profile ls
   PROFILE  ORGANIZATION    EMAIL             AUTH             API
*  default  acme            [email protected]      oauth            https://api.reoclo.com
   staging  acme-staging    [email protected]      oauth (expired)  https://api.reoclo.dev
   ci       acme            [email protected]       automation key   https://api.reoclo.com

ls also answers to list. Pass -o json for one JSON object on each line.

`current`

Shows the profile this invocation resolves to, after the CLI applies --profile and $REOCLO_PROFILE. Use it to confirm which organization a command is about to hit.

$ reoclo --profile staging profile current
profile       staging
organization  acme-staging
email         [email protected]
auth          oauth
api           https://api.reoclo.dev
streams       (derived from api)

`use <name>`

Sets the active profile. All subsequent commands use this profile unless overridden by the --profile flag (where supported) or the REOCLO_PROFILE environment variable.

reoclo profile use staging

`rm <name>`

Removes the profile and any stored token. Cannot remove the only remaining profile if you have one active.

reoclo profile rm staging

Where profiles live

Profile metadata is stored in ~/.config/reoclo/config.json (or the platform-equivalent XDG config dir). Tokens are stored separately in the OS keyring. See reoclo keyring status for details.

Examples

Set up two environments and toggle between them:

reoclo login --profile staging --api https://api.staging.reoclo.com
reoclo login --profile prod    --api https://api.reoclo.com
reoclo profile use staging

reoclo servers ls    # against staging
reoclo profile use prod
reoclo servers ls    # against prod

Run a one-off command against a non-active profile (where supported):

reoclo mcp --profile staging

reoclo login: create a profile
reoclo logout: drop the token but keep the profile
reoclo keyring: manage where tokens are stored

reoclo profile

Subcommands

ls

current

use <name>

rm <name>