Authentication
Sign in, inspect the active user, and remove credentials.
Authentication commands connect the CLI to your Plot account. Use browser login for normal interactive use, and use a personal access token for servers, scripts, or AI agents that cannot complete a browser flow.
plot login
Use plot login to start the browser-based authentication flow. After you
approve access, the CLI stores credentials locally and selects a workspace.
plot loginplot login --token
Use a personal access token when a browser login is not available. This is the right option for headless environments and automation.
plot login --token "$PLOT_API_TOKEN"Keep tokens private. Do not paste them into prompts, comments, logs, docs, or issues.
plot whoami
Use plot whoami to confirm which user and workspace the CLI is using. This is
especially useful before making updates.
plot whoamiFor structured output:
plot whoami --format jsonplot auth status
Use plot auth status to inspect credential storage and active workspace
status. This helps when you are debugging stale or missing credentials.
plot auth statusplot logout
Use plot logout to remove stored credentials for the active workspace.
plot logout