CLI Reference

Nexus CLI reference: global commands, harness commands, model selection, Anthropic and OpenAI keys, and sign-in and key storage.

Run nexus help for an overview of Nexus CLI commands, or nexus <harness> help for every option on one harness.

​

Global commands

Command	What it does
nexus login	Sign in with your browser, or paste a key you have
nexus logout	Clear the stored Fireworks key and saved Anthropic and OpenAI keys
nexus status	Show your sign-in state and every harness
nexus model list	Browse the coding model catalog
nexus auto	Show Nexus Auto’s providers, saved keys, and Provider Keys
nexus update	Update Nexus CLI
nexus uninstall	Restore every connected harness, then remove Nexus CLI
nexus help	Show help
nexus --version	Print the installed version

​

Harness commands

Command	What it does
nexus <harness>	Connect a harness. nexus <harness> on is the same
nexus <harness> off	Restore its previous settings
nexus <harness> status	Inspect the connection
nexus <harness> help	Show every option for that harness
nexus claude usage	Pick a Claude Code session and open its live cost meter
nexus claude demo	Race two models on one prompt through Claude Code
nexus claude-desktop on	Connect Claude Desktop. Quit and reopen it after on or off

• Quit Cursor IDE, VS Code, the Copilot App, and the ChatGPT desktop app before you connect or run off.
• nexus codex and nexus chatgpt switch both apps at once.
• Connect refuses a harness that isn’t installed and writes nothing.

​

Choose a model

Pass --model <id> to set the default model for new sessions. Nexus Auto (auto) is the default in every harness. The rest of the catalog stays in the picker.

nexus model list --search glm
nexus claude --model glm-fast-latest

​

Save Anthropic and OpenAI keys for Nexus Auto

Save your own Anthropic or OpenAI key so Nexus Auto can use those models, then run your harness command again.

nexus auto --anthropic-api-key     # prompts for the key (or --openai-api-key)
nexus opencode
nexus auto --unset openai-api-key  # removes the key here and from every harness

• The flag prompts for the key, so it stays out of your shell history.
• A Provider Key connected by your admin works in every harness and requires no locally saved key.

​

Sign in and key storage

Flag	Use when
--paste	Skip the browser chooser and paste a key at the prompt
--api-key fw_...	Sign in with a key directly (no prompt)
--with-token	Read a key from stdin, for CI: nexus login --with-token < key.txt
--account <id>	Sign in with Enterprise SSO, using your Enterprise SSO account ID
--force	Replace an existing stored key without a confirmation prompt
logout --revoke	Clear local credentials and revoke the key that browser sign-in created on this machine, without asking

After you rotate your Fireworks key, run nexus login again, even if you’re signed in.

​

Deprecated and removed

Deprecated commands still work and print a warning. Removed commands fail with a message that names the replacement. nexus update moves your saved settings off removed options, and the release notes record the version of each change.