Skip to main content
The auth subcommand manages your local credentials and which workspace commands act on.

​
auth login

Opens a browser for OAuth. Saves a personal access token and the list of workspaces you belong to.

​
auth logout

Deletes the local credentials file. Does not revoke the token server-side — to revoke, use the app: Settings → Personal Access Tokens → Revoke.

​
auth status

Prints:
  • Active workspace name and id
  • All saved workspaces
  • Token (redacted)
  • Server URL

​
auth workspaces list

Refreshes the workspace list from the server (falls back to cache when offline).

​
auth workspaces switch <id>

Sets the active workspace. All subsequent commands act on it.

​
auth workspaces current

Prints just the active workspace id — handy for shell scripts.

​
Multiple accounts

The CLI stores one active credential set. To use different accounts on the same machine, point NORA_TOKEN at the token you want for that command:

​
Personal vs workspace tokens

  • Personal access tokens (issued by auth login or from the app) act on any workspace you belong to.
  • Workspace tokens (from Settings → Workspace Tokens) are pinned to one workspace. Preferred for CI/CD.