Repository navigation
Releases
v0.11.0 — New Nexus sign-in page, git-free install, Nexus Auto everywhere
Highlights
nexus loginopens a new Nexus sign-in page: continue with Google, GitHub, LinkedIn, or email.- New installs no longer need git or a GitHub account: the installer downloads Nexus CLI over HTTPS. To switch an existing install, re-run the installer.
nexus updatenever installs an older version than the one you have. autois labeled Nexus Auto in every harness model picker, and Codex offersxhighandmaxeffort on it. Pickers andnexus model listnow show only the models your account can use, and after you switch accounts,nexus loginrefreshes the list so turning a harness on again picks up the new models.- Bare
nexusnow lists models in its menu, and turning on a harness reminds you that the setup only works on this computer: cloud and remote agents are not supported. - Your Fireworks key now comes only from
nexus login.onno longer accepts--api-key, and Nexus ignoresFIREWORKS_API_KEYin your shell: runnexus loginonce and turn your harnesses on.
Also improved
- Claude Desktop is now labeled Limited in help,
nexus status, andnexus claude-desktop on. Cowork and Chat can reach the web by default, andnexus loginandnexus updatenow refresh the key Claude Desktop uses, so a new key no longer ends in 401 errors. - Claude Desktop connectors:
nexus claude-desktop mcp syncandonlist which connectors moved over and which did not and why, and connectors that only work with a claude.ai account are no longer copied.nexus claude-desktop onalso connects when ~/.nexus is a link to ~/.fireconnect, and says so when another program holds its port. - Faster: turning on a harness or checking its status waits only a few seconds for a slow model listing before using the cached one, and
nexus model listnow says when it shows a cached copy and why. - Fixed: OpenCode sends the effort you pick for
autoand other models, and Codex no longer ends up with a duplicate key inconfig.toml. - Fixed:
nexus deepseek onworks with current DeepSeek Harness versions, upgrading from FireConnect 0.9 no longer leaves Claude Code on your old key, and turning Codex, Cursor, or VS Code on or off no longer stops because it wrongly thinks the app is running. - Fixed:
nexus cursor statusandnexus vscode statusno longer ask for your macOS keychain, the install banner shows the right colors in macOS Terminal, and Esc on the session list innexus claude usageexits. - Turning on a harness now checks your saved Fireworks key first. If Fireworks rejects it, Nexus stops and tells you to run
nexus login, instead of setting up a harness that fails on every turn. - Safer:
nexus uninstallkeeps your backup if turning a harness off fails,nexus logoutlists the harnesses that still hold a copy of your key, and--azureis refused on harnesses without Azure support. - API keys that
nexus logincreates are now named after this computer, and for Nexus accounts the links to manage keys point to nexus.fireworks.ai.
After upgrading, restart your harnesses to load the updated settings. Codex and the Claude Code status line show the Nexus Auto name right away; other harnesses show it the next time you turn them on.
v0.10.0 — FireConnect is now Nexus CLI
Highlights
- FireConnect is now Nexus. The command is
nexus(it replacesfireconnect), and your data moves from~/.fireconnectto~/.nexus(the old path stays as a link). Your harnesses, key, and settings carry over unchanged. Trynexus status. - Environment variables are now
NEXUS_*(FIRECONNECT_*still works). Rename them in your scripts and shell profiles when you get a chance. - FireRouter is retired.
nexus upgrademoves every harness that was on a FireRouter route toauto, and picking a FireRouter model now fails with a pointer toauto: FireRouter routes are no longer supported. Use--model autoinstead. - Narrow
autoto Fireworks-hosted models only:nexus auto --providers fireworks. The setting is global, not per harness.nexus auto --resetrestores the default. Claude Desktop and DeepSeek Harness support the setting too.
Improvements
- Claude Desktop works on Linux too:
nexus claude-desktoproutes Chat, Cowork, and Code through Fireworks there as well as on macOS.
After upgrading, restart your harnesses to pick up the new model settings.
Install
curl -fsSL https://raw.githubusercontent.com/fw-ai/nexus-cli/main/install.sh | bashv0.9.9 — Codex on FireRouter with your own sign-in, MCP in Codex, key rotation everywhere
Highlights
- Codex starts on FireRouter, and GPT turns run on your own sign-in. A fresh
fireconnect codexpicksfirerouterand asks you tocodex loginwith ChatGPT or an OpenAI key. Easy turns stay on open models, and the GPT models your sign-in offers sit right above the Fireworks catalog in/model.fireconnect upgradeswitches existing setups over and keeps your model. - MCP servers and ChatGPT app connectors work in Codex. Their tools reach the model, so calls complete instead of the model saying a server "exposes no tools".
fireconnect upgradefixes existing setups. - Rotate your Fireworks key without breaking a harness.
fireconnect loginnow saves the new key into every connected harness, VS Code included, even when you're already signed in. No more 401s from a harness holding the old key. - OpenCode v2 lists your Fireworks models. When
opencode.jsonuses v2'sprovidersmap, FireConnect writes Fireworks there too, soautoand the rest show up in/modelsinstead of silently going missing.fireconnect upgraderepairs existing setups.
Improvements
- Fixed: OpenCode's
/modelsno longer lists routers likeglm-latesttwice.fireconnect upgradecleans up existing configs. - Fixed: Claude Desktop works behind TLS-inspecting corporate proxies such as Zscaler. Re-run
fireconnect claude-desktop onto pick it up. - Fixed: with Node from fnm,
fireconnectcould stop finding Node in new or non-interactive shells. Re-run the installer once to fix an existing install. - New:
fireconnect configure --unset openai-api-keyand--unset anthropic-api-keyclear a saved provider key from FireConnect and from every harness holding a copy. - Clearer errors: when the model catalog can't load, you see the gateway's actual answer instead of a generic "reconnect to the network".
- Heads-up: Claude Code no longer takes
--anthropic-api-key. Claude turns already use Claude Code's own sign-in (claude loginor an exportedANTHROPIC_API_KEY), and your nextfireconnect clauderemoves any key an earlier version saved. - Heads-up: Codex no longer supports Azure/Foundry, because Codex CLI 0.160 removed the only transport Foundry offers. Run
fireconnect configure --provider fireworksto put Codex back on the Fireworks gateway. OpenCode, Pi, Cursor, and VS Code still support Foundry.
After upgrading, restart Codex and OpenCode. If Codex asks you to sign in, run
codex login.
Install
curl -fsSL https://raw.githubusercontent.com/fw-ai/fireconnect/main/install.sh | bashv0.9.8 — Claude Desktop on Fireworks, Claude tier pins, FireRouter OpenAI BYOK
Highlights
- Claude Desktop runs on Fireworks. On macOS,
fireconnect claude-desktop onroutes Chat, Cowork, and Code through Fireworks, starting onauto. Bring your connectors along withfireconnect claude-desktop mcp sync, andoffputs your previous setup back exactly as it was. - Pin Claude Code tiers again. Keep Claude as your main model and hand subagents to an open model:
fireconnect claude --sonnet deepseek-flash-latest --subagent deepseek-flash-latest. Re-runningonkeeps your pins, andnativereleases a slot. - FireRouter can reach OpenAI's frontier models. Save your key once with
fireconnect configure --openai-api-key sk-.... It rides along only on FireRouter picks and is never required. Cursor, Copilot, and DeepSeek Harness can now pick plainfireroutertoo. - New Anthropic and OpenAI models show real dollars as soon as models.dev lists them. The status line,
fireconnect claude status, and demo estimates read a cached price snapshot, so a model launch no longer waits on a FireConnect release. Offline, the last snapshot still prices your session.
Improvements
- Fixed:
fireconnect claude --model <id>could report success without adding the model. It now becomes your default and shows up in/model, and your own picker rows stay untouched. - Fixed: Codex auto-review denied every approval. It called an OpenAI-only reviewer that Fireworks can't serve; now the model you picked does the review.
- Fixed:
--modelon a first-timeonleft Codex with a one-model menu. You now get the model you asked for plus the full catalog. - Fixed: DeepSeek Harness 0.1.7 and later asked for a DeepSeek API key on first launch. It now goes straight to Fireworks.
- Heads-up: Claude Code auto mode may show a "classifier requests are billed" notice once per session. Nothing is broken. Auto mode's safety checks run on your Sonnet model, so they bill to Anthropic unless you pin Sonnet with
fireconnect claude --sonnet <id>. - New:
fireconnect models, a shortcut forfireconnect model list. The list now says when to use each smart router:autobalances cost and quality,auto-instantis latency-first. If your account disables fast models, stay onauto.
Using Codex auto-review or DeepSeek Harness? Run
fireconnect codex onorfireconnect deepseek ononce after upgrading to pick up the fixes.
Install
curl -fsSL https://raw.githubusercontent.com/fw-ai/fireconnect/main/install.sh | bashv0.9.7 — GitHub Copilot support, Claude keeps tier models, auto everywhere
Highlights
- GitHub Copilot works with Fireworks.
fireconnect copilot-appconnects the desktop app,fireconnect copilot-clithe CLI. Your own models stay;offremoves only what FireConnect added. - Claude Code keeps its own tier models. The Fireworks catalog is added to the
/modelpicker instead of overriding slots. Older pinned slots are released on the nextfireconnect claude on. - Every other harness starts on
auto, the cost-aware mix, also selectable in every picker. - Claude Code web search and fetch go through Fireworks natively; the old
fireworks-websearchMCP is removed on upgrade, your own MCPs untouched. - Codex web search works again; upgrade cleans up the 0.9.6 override.
Improvements
- The built-in Explore agent follows your session model again instead of always using Opus. Fixed on upgrade.
- Pickers stay fresh: re-running
onprunes retired models, adds new ones, and updates pricing and metadata. Upgrade refreshes the Claude picker too. - Codex auto-compacts at 80% of the context window so long sessions survive; GLM-5.3 models unlock max reasoning effort.
Install
curl -fsSL https://raw.githubusercontent.com/fw-ai/fireconnect/main/install.sh | bashv0.9.6 — Codex 0.153 fix, cleaner cost breakdown
Highlights
- Codex 0.153 works with Fireworks again. Codex 0.153 turns on a
web_searchtool the Responses API can't accept; FireConnect now bakesweb_search = "disabled"and repairs existing setups onfireconnect codex on. - Cleaner cost breakdown — the status line and meter dedupe and name model labels instead of listing the same one twice.
Improvements
- Claude Fable 5.1 pricing added; estimates and
fireconnect model listare accurate. - Subagent slot keeps its
[1m]tag when routed. fireconnect model listaligns price precision across models.fireconnect claude demodisables your user MCPs so they can't skew the race.
Using Codex? Run
fireconnect upgradeand 0.153 keeps working through Fireworks.
Install
curl -fsSL https://raw.githubusercontent.com/fw-ai/fireconnect/main/install.sh | bashv0.9.5 — Claude status line, ChatGPT desktop app, smart router mixes (preview)
Highlights
- Session costs in your Claude prompt. A new status line shows which models ran, what they cost at Fireworks rates, and cache savings. Your own status line is left alone —
fireconnect claude offrestores everything. - ChatGPT desktop app support.
fireconnect chatgptandfireconnect codexshare one config, so you route both through Fireworks with a single command. Quit the app first so its model list refreshes. - Smart router mixes (preview). Pin
autofor the default mix orauto-instantfor latency-first routing — for example,fireconnect claude --sonnet auto-instant. Everyauto-*slug works the same way. - Simpler Claude model setup. The wizard lets you pick a model per slot instead of toggling fast profiles. New installs default to Sonnet on
deepseek-pro-latest, Opus onglm-latest, and Fable on vision-capableglm-flash-latest. FireRouter still lands on Opus at first connect when your key supports it. - Faster
fireconnect model list. Results are cached for an hour, work offline, show when they were last updated, and--refreshpulls the latest. Smart Routers listsauto,auto-instant, and FireRouter.
Improvements
- MCP tool search works through the Fireworks gateway again — upgrade applies the fix automatically.
fireconnect claude demoand the status line use the same pricing, so their numbers always match.fireconnect upgraderepairs missing dependencies; partial installs recover instead of crashing.- Linux SSH/WSL: keys store in an encrypted file with timeouts on keyring and network calls — no more hangs.
fireconnect claude statusshows every slot, including defaults you never explicitly set.- GLM 5.3 and GLM 5.3 Flash added. Stale pins no longer hide newer releases; US-only pricing corrected.
- Claude picker lists
autoon every slot andauto-instanton Sonnet only.
Already on Claude? Upgrade keeps your slot picks — run
fireconnect claude --interactiveto adopt the new defaults. Legacy pins likedeepseek-v4-flashmove todeepseek-flash-lateston your nextfireconnect claude on.
Install
curl -fsSL https://raw.githubusercontent.com/fw-ai/fireconnect/main/install.sh | bashv0.9.4 — Claude demo cost accuracy, safer Cursor on/off and uninstall
Highlights
fireconnect claude demo: improved cost calculation and racing experience.fireconnect cursor on/off: more robust; uninstall now waits for Cursor to quit before restoring, preventing broken state.fireconnect uninstall: paced, harness-by-harness checklist that waits for IDEs to quit.
Install
curl -fsSL https://raw.githubusercontent.com/fw-ai/fireconnect/main/install.sh | bashv0.9.3 — Anthropic+Fireworks Claude defaults, DeepSeek harness, demo
Highlights
- New Claude Code defaults: Sonnet on Anthropic's own model, Opus on
deepseek-pro-latest, Haiku and subagents ondeepseek-flash-latest. Change them withfireconnect claude --interactive. - Anthropic and Fireworks models both work once fireconnected — mix them freely.
fireconnect claude demoraces two live Claude Code sessions side by side.- DeepSeek Harness replaces Deep Agents —
fireconnect deepseek on.
Improvements
fireconnect statusno longer reports "All off" while models are routed.- OpenCode shows per-model cost, and hides it for Fire Pass subscriptions.
Pinned
deepseek-v4-flash? Your nextfireconnect claude onmoves it todeepseek-flash-latest.
Install
curl -fsSL https://raw.githubusercontent.com/fw-ai/fireconnect/main/install.sh | bashv0.9.2 — Claude live usage meter, Cursor/VS Code fixes, harness improvements
Highlights
- Live session cost meter — watch Fireworks spend accumulate in a tmux split pane beside Claude Code, with a recent-session picker.
- VS Code now uses the chat-completions API for better compatibility.
- Cursor picker hides built-in models and preserves your native model IDs when re-enabling.
Improvements
- FireRouter model IDs are treated as 1M-context; Kimi K3 specs corrected to 1M with
[1m]enabled for Claude. - Linux quit detection ignores Electron helper processes in VS Code.
- Claude usage meter exits cleanly on quit.
- README rewrite.
Install
curl -fsSL https://raw.githubusercontent.com/fw-ai/fireconnect/main/install.sh | bash