Prism CLI

Connect LLM provider accounts and clients to Prism.

Install

brew install circlesac/tap/crcl circlesac/tap/prism

If crcl is already installed, Prism CLI can also be installed directly:

curl -fsSL https://github.com/circlesac/prism-cli/releases/latest/download/install.sh | sh

Sign in

crcl login

Usage

Show ChatGPT, Anthropic, Copilot, OpenCode Go, Cursor, and Gemini subscription usage together:

prism usage

Each provider is fetched independently, so an unavailable login does not hide usage from the other providers.

Non-interactive API calls

Use prism exec when a shell pipeline or CI job needs one request through Prism. The API type is explicit and the JSON request can come from stdin or a file:

cat request.json | prism exec --api chat --model gpt-4.1 --provider copilot
prism exec --api responses --body request.json --output-format text

The supported API mappings are:

--api	Endpoint
chat	/v1/chat/completions
completions	/v1/completions
responses	/v1/responses
messages	/v1/messages

Output is JSON by default. Use --output-format text for textual assistant output or --output-format stream-json for one JSON object per SSE event. --json is shorthand for the default JSON mode. --model overrides a model in the request body, and --provider is sent as Prism's routing hint.

For headless CI, provide the normal Circles credential through the environment and keep it scoped to the command. For example, with a cvlt-backed reference:

CIRCLES_AUTH_TOKEN=vlt://github.com/example-org/example-repo/PRISM_CI_CIRCLES_KEY

cvlt run --env-file=.cvlt.env -- prism exec --api responses --output-format json < request.json

The CLI never accepts credentials as command-line arguments or reads GitHub OIDC variables directly. See prism exec --help for all options and the documented exit-code classes.

Local runtime relay

Container runtimes can reach Prism without mounting the host credential store:

PRISM_RELAY_TOKEN=<random-one-shot-token> prism relay claude --port 0
PRISM_RELAY_TOKEN=<random-one-shot-token> prism relay codex --port 0
PRISM_RELAY_TOKEN=<random-one-shot-token> prism relay gemini --port 0

The relay keeps the Prism credential and account selection in the host process. It accepts only the selected provider's API route and requires the one-shot token on every proxied request. Port 0 selects an available port. The relay listens on all host interfaces so a local container can reach it; callers must generate a fresh token of at least 32 characters and stop the relay with the container invocation.

Cursor

Install the official Cursor Agent without replacing an existing ~/.local/bin/agent, then register one or more accounts with Cursor's supported browser flow:

prism cursor install
prism cursor login
prism cursor login --name work-admin
prism cursor auth list
prism cursor status
prism cursor models

Run Cursor Agent through Prism while passing its arguments through unchanged:

prism cursor --mode ask -p 'Reply with exactly CURSOR_OK.'
prism cursor --account work-admin --mode ask -p 'Reply with exactly CURSOR_OK.'

Prism disables Cursor Agent's self-updater on every launch. Use prism cursor update (or prism cursor upgrade) to install the latest official package while preserving the separate agent command.

Show the monthly Cursor Models and Other Models pools separately:

prism cursor usage

Without --account, Prism rotates across the registered accounts. Usage shows all registered accounts; pass --account to show one. To migrate the Cursor login that was active before this feature, run:

prism cursor auth import

Each login remains in an isolated profile supported by the official Cursor Agent, and Prism never prints its token. Because Cursor does not publish a standalone usage CLI contract, usage is a read-only best-effort integration and reports an explicit error when the login or quota response is unavailable.

Gemini subscription

Sign in to Antigravity with each Google subscription account and import the active login into Prism. Repeat the first two commands for every account, then run the official Gemini CLI through the shared pool:

agy -p /usage --output-format json
prism gemini auth import
prism gemini auth list
prism gemini usage
prism gemini -p 'Reply with exactly GEMINI_OK.'

Prism rotates across registered subscription accounts unless --account selects one:

prism gemini --account work-admin -p 'Reply with exactly GEMINI_OK.'

AI Studio API keys are intentionally unsupported because they can incur usage-based charges. prism usage and prism gemini usage show every registered subscription account.

The default model is gemini-3.7-flash-low. For harder software-engineering or multi-step tool-use tasks, select gemini-3.1-pro-high explicitly:

prism gemini --model gemini-3.1-pro-high -p 'Review this repository.'

prism gemini auth login remains available for organization-managed Gemini Code Assist OAuth accounts. Imported Antigravity logins and Code Assist accounts are stored separately and selected by the same rotation mechanism.

Anthropic

Register each Claude subscription account separately and show its current quota:

prism anthropic auth login
prism anthropic auth list
prism anthropic usage
prism anthropic auth remove <credential-id>

prism claude login is a short alias for prism anthropic auth login. The browser handles account selection, SSO, and MFA. Prism does not import the credential used by an existing Claude Code login.

This stores and refreshes Anthropic credentials for account and usage management, and prism claude forwards requests through a local bridge while keeping Claude Code’s existing OAuth/login mode.

prism anthropic auth remove deletes the Prism grant and its routing/usage state. Anthropic does not document a revocation endpoint for this grant, so the command does not claim provider-side revocation; use Anthropic account security settings when provider-side invalidation is required.

ChatGPT

prism chatgpt auth login
prism chatgpt auth list
prism chatgpt usage
prism chatgpt auth remove <credential-id>

Run prism chatgpt auth login again to add another ChatGPT account. Usage reset times are shown in the local timezone with the remaining time.

OpenCode Go

Show usage from an OpenCode login already present in Chrome, Chromium, Comet, Arc, Edge, Brave, or Firefox on macOS:

prism opencode-go usage

Prism reads the browser session only for this request. It does not save or print browser cookies. The output includes rolling, weekly, and monthly reset times and whether the current usage pace is likely to exhaust each limit.

Other providers

prism copilot auth login

prism groq auth add --name personal
prism mistral auth add
prism deepseek auth add
prism opencode-go auth add
prism cloudflare auth add --provider-account-id <cloudflare-account-id>
prism vercel auth add --owner-id <vercel-owner-id>
prism gemini-app auth add

Use the same auth list and auth remove commands for each provider:

prism groq auth list
prism groq auth remove <credential-id>

Codex

Route Codex App and CLI tasks through Prism:

prism codex enable
prism codex status

prism codex enable selects gpt-5.6-sol, uses the model's default reasoning effort, and updates the shared user-level Codex configuration. Open a new Codex task after enabling it. The App and CLI then use the same Prism configuration, and the CLI can still be started normally:

codex

Verify the setup:

codex exec --ephemeral 'Do not use any tools. Reply with exactly PRISM_OK.'
prism chatgpt usage

Restore the Codex settings that were present before Prism was enabled:

prism codex disable

Prism only restores settings that still match what enable applied. If a managed setting was edited afterward, prism codex status reports drift and disable leaves the changed setting untouched.

Claude Code

Install Claude Code so that claude is available on PATH, then use the Claude Code interface and tools with any model supported by Prism:

prism claude --model gpt-5.6-sol

Use Claude Code's Ultracode dynamic workflow with GPT-5.6 Sol:

prism claude --model gpt-5.6-sol --effort ultracode

These examples use gpt-5.6-sol; replace it with another Prism-supported model when needed. prism claude launches the installed Claude Code CLI and passes its arguments through unchanged. Claude models use the registered Anthropic account pool automatically. To start a session on one account, pass its alias or redacted id before the Claude Code arguments:

prism claude --account work-admin --model claude-fable-5

Verify the setup:

prism claude --model gpt-5.6-sol --print --tools "" -- \
  'Do not use any tools. Reply with exactly PRISM_CLAUDE_MODEL_OK.'

A successful request ends with PRISM_CLAUDE_MODEL_OK. Run claude --help to see all Claude Code options.