Reflexio Docs
CLI Reference

auth & status

Authenticate to a Reflexio server and inspect org identity, storage, and health.

reflexio auth / reflexio status

Two related groups cover authentication and server identity:

  • auth — save, inspect, and clear local credentials in ~/.reflexio/.env.
  • status — check that the server is reachable and reports the expected identity.

reflexio auth login

Save authentication credentials to ~/.reflexio/.env. The file is created with restricted permissions.

reflexio auth login [--api-key <key>] [--server-url <url>]

Prop

Type

If neither flag is passed, nothing is written and the command prints a hint.

reflexio auth login \
  --api-key sk-reflexio-... \
  --server-url https://www.reflexio.ai

reflexio auth status

Print the current credentials as seen by the CLI. The API key is masked.

reflexio auth status

Output lists the resolved URL, the masked API key, and the path to the env file it was loaded from.


reflexio auth logout

Delete the stored credentials by removing ~/.reflexio/.env.

reflexio auth logout

This removes the entire user-level env file, not just the Reflexio entries. If you keep other variables there, back them up first.


reflexio status check

Make a GET /health request and report whether the server is reachable and healthy.

reflexio status check

Exits with code 1 if the server cannot be reached or returns a non-2xx status.


reflexio status whoami

Show who you are on the server and where your data lands. Calls GET /api/whoami and reports the org ID, resolved storage type, masked storage label, and whether storage is configured. Use this to sanity-check that you're pointing at the right backend.

reflexio status whoami

If whoami reports self-host-org for your org ID on a remote server, auth is not being enforced — the CLI is effectively hitting a shared default namespace. Contact the server operator.