CLI Commands

pensar auth

Overview

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

Usage

$pensar auth [subcommand]

Subcommands

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

Login Flow

$pensar auth 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 auth will show your current status and offer to reconnect.

Checking Status

$pensar auth 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 auth logout

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

/auth

Connect via the TUI with the same device flow

pensar projects

List workspace projects (requires auth)