Package Exports

@hexanexus/nexus-switch

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@hexanexus/nexus-switch) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

◢ NEXUS SWITCH

AI model router · by HexaNexus

Route Claude Code across 8 AI providers — free tiers first, one command.

Nexus Switch is a terminal launcher and router for Claude Code. It sets the right environment for each provider, optionally starts a local LiteLLM proxy, and hands the terminal to claude — no global config, no profile edits.

Nexus Switch is not affiliated with Anthropic. It launches the claude CLI you install yourself.

Install

npm i -g @hexanexus/nexus-switch
nexus doctor          # verify claude, keys, and proxy are ready

Requires: Node.js ≥ 18 and @anthropic-ai/claude-code.

Quick start

nexus                 # interactive TUI — pick provider and model
nexus groq            # launch directly on Groq (free tier)
nexus ollama          # local or cloud Ollama model
nexus openrouter      # OpenRouter free-tier models

The TUI is a hub: models are sorted cheapest-first, every row carries its billing tier, and the highlighted model's real cost is spelled out before you launch anything. When claude exits, you land back in the picker — not in the shell.

 ◢ NEXUS SWITCH                              v1.3.1 · proxy ● :4000

 Groq (via LiteLLM proxy)  ·  9 modeles
 ────────────────────────────────────────────────────────────────
 ▸ ● QUOTA   Llama 3.3 70B Versatile   cloud · 131K · $0.59/0.79
   ● QUOTA   GPT-OSS 120B              cloud · 131K · $0.15/0.6
   ● QUOTA   Qwen3 32B                 cloud · 131K · $0.29/0.59

 ▍ Gratuit jusqu'au quota (compte groq gratuit requis)
   — au-delà : $0.59 in / $0.79 out par M tokens.

 ↑↓ naviguer · ⏎ lancer · ← providers · q quitter

Providers

Provider	Free tier	Account	Notes
Groq	✅ rate-limited	Required	`nexus key set groq <key>`
Gemini	✅ generous	Required (Google)	`nexus key set gemini <key>`
Mistral	✅ experimental	Required	`nexus key set mistral <key>`
Cerebras	✅ ~1M tok/day	Required	`nexus key set cerebras <key>`
NVIDIA NIM	✅ 1000 credits	Required	`nexus key set nvidia <key>`
OpenRouter	✅ 50 req/day	Required	`nexus key set openrouter <key>`
Ollama local	✅ unlimited	None	`ollama pull <model>`
Ollama cloud	✅ quota (some models Pro-only)	Required	`ollama signin`
Anthropic	❌ paid	Required	`nexus key set anthropic <key>`

The TUI labels every model's billing tier, and the picker explains the highlighted model's cost in plain words:

GRATUIT (green) — runs locally, no account, never billed
QUOTA (yellow) — free provider account required; free up to a usage quota, then blocked or billed
PAYANT (red) — billed per token from the first request
UPGRADE (magenta) — unusable without a paid subscription (e.g. some Ollama cloud models 403 on a free account)

Commands

nexus                             # interactive TUI (provider → model → launch)
nexus <provider> [model] [flags]  # direct launch, e.g. nexus groq llama-3.3-70b-versatile
nexus key set <provider> <key>    # save a provider API key
nexus key list                    # list configured keys (masked)
nexus key delete <provider>       # remove a key
nexus doctor                      # check claude CLI, keys, and proxy status
nexus credits                     # show remaining credits/quota per provider
nexus refresh                     # sync the model catalog from provider APIs
nexus proxy start                 # start the LiteLLM proxy (auto-started on need)
nexus proxy stop                  # stop the proxy
nexus update                      # update nexus-switch to the latest release
nexus uninstall                   # uninstall

Documentation

docs/ARCHITECTURE.md — runtime flow, module map, platform layer
docs/PROVIDERS.md — per-provider setup and key commands

Legal

Nexus Switch is an independent open-source project, not affiliated with or endorsed by Anthropic, Google, Mistral, or any other provider. "Claude" and "Claude Code" are trademarks of Anthropic, PBC, referenced here solely to describe interoperability. Nexus Switch does not bundle or redistribute Claude Code — it launches the claude CLI you install separately. You are responsible for complying with each provider's terms of service. See NOTICE.

License

MIT — see LICENSE.