Skip to main content

Authentication

Login​

revos auth login

Opens your browser for OAuth authentication. After completing the flow, the CLI stores your credentials locally and picks your default organization:

  • Inside a project (a revos.yaml is discovered walking up from the current directory) — uses metadata.orgId from revos.yaml; no prompt.
  • Outside a project, one org — auto-selects it.
  • Outside a project, multiple orgs — prompts you to pick.

Requires: An active RevOS account.

Remote or headless machines (SSH, Codespaces)​

By default login starts a temporary http://localhost callback server and opens your browser. In GitHub Codespaces the CLI detects this automatically and switches to a no-server flow: it prints a URL for you to open in any browser, and you paste the code shown there back into the terminal.

For any other setup where the browser can't reach the CLI's localhost — an SSH session, a plain container, a headless host — pass --no-localhost (or set REVOS_AUTH_NO_LOCALHOST=1) to use the same paste flow:

revos auth login --no-localhost

A local VS Code dev container needs neither — the editor forwards the callback port to your host and opens your host browser, so the default flow works there.

Logout​

revos auth logout

Clears locally stored credentials.

Check Status​

revos auth status

Shows whether you're authenticated and which account is active.

revos auth status --json

Returns auth status as JSON — useful for scripting.

Using the Token in Other Tools​

revos auth token

Prints the access token on its own, so it drops into another command:

curl -H "Authorization: Bearer $(revos auth token)" https://api.revos.ai/tables

The token does not name an organization, so requests made this way also need the organization id. --json returns both, along with when the token expires:

revos auth token --json

A token that has expired is refreshed automatically, the same way it is for every other command, so this keeps working long after you signed in. If you are not signed in at all, the command fails and tells you to sign in rather than printing something the API would reject.

Token-Based Auth (CI/CD)​

For non-interactive environments, set the REVOS_TOKEN environment variable instead of using revos auth login:

export REVOS_TOKEN=your-token-here
revos org list

See Configuration for all environment variables.