Quick start
Install and sign in
git, and bash. On Windows, run it from Git Bash; PowerShell breaks the script’s line endings.Connect Pi
Restart Pi
Restart Pi if it was running. The default model is
auto.nexus pi status shows the provider, where the key comes from, and the configured model.Use Nexus Auto
Nexus Auto (auto) is supported on the Chat Completions API.
- Anthropic and OpenAI model turns: connect an Anthropic or OpenAI Provider Key. Nexus CLI doesn’t send local keys on
auto. - Manual setup: send
x-anthropic-api-keyandx-openai-api-keyheaders yourself. See Manual setup (advanced).
MCP and tools
Nexus CLI doesn’t touch MCP. Set up servers in Pi as usual. Nexus CLI does not add web search to Pi. See Web Search.Troubleshooting
See Nexus Auto for issues that affect every harness.Manual setup (advanced)
Pi has a built-infireworks provider that reads FIREWORKS_API_KEY. Set it as the default:
~/.pi/agent/settings.json
pi -p "hello" answers from GLM.What the Nexus CLI writes
~/.pi/agent
settings.json
auth.json
models.json
See what Nexus CLI writes
See what Nexus CLI writes
~/.pi/agent/settings.json
~/.pi/agent/auth.json
settings.json already has an enabledModels list, Nexus CLI appends fireworks/** to it. Otherwise it leaves enabledModels out.models.json adds a providers.fireworks entry with rows for models Pi’s built-in fireworks catalog lacks, such as auto. off restores the whole providers.fireworks entry to what it was before you connected. Use --settings-path for a settings file stored elsewhere.