CLI Commands

pensar login

Overview

The pensar login command connects your CLI to Pensar Console for managed inference. This is the headless equivalent of the TUI /login command — it uses the same device authorization flow but runs entirely in the terminal without the TUI.

The pensar auth command still works as an alias for backward compatibility, but pensar login is now the primary command name.

Usage

$pensar login [subcommand]

Subcommands

SubcommandDescription
pensar loginStart the login flow (or show status if already connected)
pensar login statusShow current connection status
pensar login logoutDisconnect from Pensar Console

The legacy pensar auth command and subcommands still work for backward compatibility.

Login Flow

$pensar login
  1. Apex requests a device code from the Pensar authentication service
  2. A browser window opens to the verification URL
  3. Enter the user code displayed in your terminal to confirm
  4. Select a workspace (if your account has multiple)
  5. Apex stores the auth tokens locally

If you’re already connected, pensar login will show your current status and offer to reconnect.

Checking Status

$pensar login status

Displays your auth type (WorkOS or API key) and current workspace. When using API key auth, the command resolves your workspace from the server if it isn’t already stored locally.

✓ Connected to Pensar Console
  Workspace: my-team (my-team)
  Auth: WorkOS

Logging Out

$pensar login logout

Clears stored authentication tokens from your local configuration. You can reconnect at any time by running pensar login again.

/login

Connect via the TUI with the same device flow

pensar projects

List workspace projects (requires login)