Skip to main content

Authentication

The CLI uses browser-based OAuth login through the FissionBox platform.

Login​

fissionbox auth login

This will:

  1. Open your browser to the FissionBox login page
  2. Let you sign in through Google OAuth
  3. Redirect back to a local CLI callback on 127.0.0.1
  4. Store the returned platform user token in ~/.fissionbox/config.json

Shell Eval Mode​

For CI or scripting, use --shell to get export statements:

eval "$(fissionbox auth login --shell)"

Check Status​

fissionbox auth status

Returns JSON with your current configuration:

{
  "auth_host": "https://www.beta.platform.fissionbox.ai",
  "platform_host": "https://api.beta.platform.fissionbox.ai",
  "fissionbox_host": "https://api.beta.fissionbox.ai",
  "default_namespace_id": "ns-abc123",
  "has_platform_api_key": false,
  "has_platform_user_token": true,
  "config_path": "/Users/you/.fissionbox/config.json",
  "auth_header": "Authorization"
}

Logout​

fissionbox auth logout

Clears stored tokens from ~/.fissionbox/config.json.

Shell Eval Mode​

eval "$(fissionbox auth logout --shell)"

Config Storage​

Credentials are stored in ~/.fissionbox/config.json. Only the token and default namespace are persisted. Host overrides come exclusively from environment variables and are never written to the config file.