llm-switcher weekly downloads statistics

LLM Switcher

<p align="center"> <b>Zero-dependency, multi-protocol edge gateway & provider switcher</b><br> Bridge <b>Claude Code</b>, <b>Codex</b> and the <b>Antigravity CLI</b> to any upstream LLM API: OpenAI-compatible, Anthropic, or Vertex.<br> Full bi-directional protocol conversion, official-model context windows, thinking protocol extraction, and edge message healing. </p> <p align="center"> <b>English</b> • <a href="README.vi.md">Tiếng Việt</a> </p> <p align="center"> <img src="https://img.shields.io/badge/Node.js-18%2B-22c55e?logo=node.js&logoColor=white" alt="Node.js 18+"> <img src="https://img.shields.io/badge/Dependencies-Zero-38bdf8" alt="Zero Dependencies"> <img src="https://img.shields.io/badge/Context-window_follows_the_model-6366f1" alt="Context window follows the model"> <img src="https://img.shields.io/badge/Multi--Active-Concurrent_CLIs-f59e0b" alt="Multi-Active"> <img src="https://img.shields.io/badge/License-MIT-gray" alt="License MIT"> </p>

---

🛡️ Zero-Loss Native Emulation for Coding Agents

Generic proxies mangle response protocols: Anthropic loses thinking_delta reasoning blocks, tool arguments split, and prompt caches desynchronize.

LLM Switcher solves this at the local network edge:

• 100% Native Emulation: Normalizes upstream APIs (intact, 9Router, Vertex, DeepSeek) into genuine Anthropic SSE (thinking_delta + tool_use) for Claude Code, and genuine Responses API events for Codex.
• Client-Side Edge Companion: Intentionally offloads heavy account pooling and key rotation to intact (recommended) or 9Router (basic alternative), keeping LLM Switcher zero-dependency and bloat-free.
• Targeted Tool Scope: Built specifically for Claude Code, OpenAI Codex and the Antigravity CLI (agy). OpenCode supports custom models without shims; refer to intact for account pooling.

---

Architecture & Interactive Diagrams

LLM Switcher runs locally on your workstation (127.0.0.1:3456) as a transparent edge interceptor and protocol bridge.

<p align="center"> <a href="docs/diagrams/system-architecture.html"> <img src="docs/diagrams/system-topology.svg" alt="LLM Switcher System Topology & Architecture" width="100%"> </a> <br> _{<i>🎨 Themed with Pretty-Mermaid (Tokyo Night). Click diagram to open interactive Archify viewer (zoom, pan, tracing).</i>} </p>

1. Interactive Archify Visual Library

All architecture maps and execution sequences are authored with Archify and rendered with Pretty-Mermaid:

Diagram	Description	Interactive Visual	Scalable Vector
System Topology	Complete edge architecture: Clients ➔ Optimizers ➔ Gateway & Healer Core ➔ Upstream Providers	📊 Open Interactive View	SVG • PNG
IR Healer Pipeline	Inbound request normalization, schema healing, streaming synthesis, and abort propagation	🔄 Open Interactive View	SVG • PNG
Codex Blindfold Routing	TLS CONNECT proxy sequence, credential scrubbing, and upstream routing	🛡️ Open Interactive View	HTML
Switch Lifecycle	Zero-downtime tool toggle, CAS configuration writes, and interceptor sync	⚡ Open Interactive View	HTML

---

2. Request Lifecycle & Healer Pipeline

<p align="center"> <a href="docs/diagrams/ir-translation-pipeline.html"> <img src="docs/diagrams/ir-healer-pipeline.svg" alt="Bi-Directional IR Healer Pipeline" width="100%"> </a> <br> _{<i>💡 Click above to inspect the interactive IR Healer lifecycle sequence.</i>} </p>

3. High-Level Flow

flowchart LR
    classDef client fill:#1e293b,stroke:#38bdf8,stroke-width:2px,color:#f8fafc;
    classDef edge fill:#0f172a,stroke:#6366f1,stroke-width:2px,color:#f8fafc;
    classDef healer fill:#064e3b,stroke:#10b981,stroke-width:2px,color:#f8fafc;
    classDef upstream fill:#2e1065,stroke:#a855f7,stroke-width:2px,color:#f8fafc;
    classDef opt fill:#1e1b4b,stroke:#818cf8,stroke-dasharray: 4 4,color:#e0e7ff;

    subgraph Clients[" 💻 Dev Clients & Coding CLIs "]
        CC["Claude Code CLI\n(/v1/messages)"]:::client
        CDX["OpenAI Codex CLI\n(/v1/responses)"]:::client
    end

    subgraph Middle[" ⚡ Optional Middle-Layer "]
        OPT["Token Optimizers\n(Headroom / RTK)"]:::opt
    end

    subgraph Gateway[" 🛡️ LLM Switcher Edge Gateway (:3456) "]
        ROUTER["Edge Router\n(Zero-Mutation)"]:::edge
        HEALER["Healer Engine\n(Auto-Fix Schemas)"]:::healer
        IR["Bi-Directional IR\n(Event Synth)"]:::healer
        ROUTER --> HEALER --> IR
    end

    subgraph Upstreams[" ☁️ Upstream Providers "]
        INTACT["intact Gateway\n(Recommended Pooler)"]:::upstream
        OTHER["9Router / Vertex / Other"]:::upstream
    end

    CC -->|direct| ROUTER
    CDX -->|direct| ROUTER
    CC -.->|prune| OPT
    CDX -.->|prune| OPT
    OPT -->|forward| ROUTER

    IR -->|contract & pool| INTACT
    IR -->|standard call| OTHER

---

4. How It Actually Works: Transparent Request Interception

LLM Switcher acts as a transparent man-in-the-middle without ever touching client configuration files:…