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.

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.