ClaudeMap

magpie

A menu bar app plus a local gateway that puts any model behind the 75 agents on its supported list — Claude Code on Kimi, Codex on DeepSeek, Gemini CLI on GLM, OpenCode on your ChatGPT plan — with quiet failover when a quota runs out (MIT)

SDKs & Toolinggatewaymodel routingmenu bar appsubscription failovermulti-agent

magpie is yetone's open-source local model gateway and switcher (MIT; 33,076 stars as of writing, 2026-11-10) with the slogan "Every agent's model. One place": each agent keeps its model in its own file, in its own format, with its own keys, and a subscription you pay for works in one agent and nowhere else — magpie puts all of that behind one app and one local gateway. Pick any model for any agent from one list on the Agents page, and magpie edits the one key that matters in the agent's own config; the supported list names 75 agents, from Claude Code, Claude Desktop, Codex, Gemini CLI, Goose, Zed and Cursor CLI to ZCode, Devin and Cline, and anything that takes a base URL can use the gateway. The gateway at 127.0.0.1:3425 speaks OpenAI Chat, OpenAI Responses, Anthropic Messages and Gemini, and translates between them — streaming, tool calls and reasoning included. Subscription reuse without pasting keys: magpie finds the plans your agents are signed in to by reading their sign-ins (Claude Code's and Codex's files, the macOS Keychain) — Claude, ChatGPT, Copilot, Gemini or Grok plans are all in scope. When a quota runs out, a provider's next account takes over and a routing group moves on to another model or provider, so the agent never sees the error; with one account and no group the error reaches the agent. For privacy, on-device masking (Settings → Privacy, off by default) masks keys, passwords and emails before the request leaves your computer and puts them back in the reply. It runs as a macOS, Windows and Linux menu bar app, window, TUI, web UI and CLI, plus Docker and Termux; there are profiles, a magpie quota dashboard, and image, vision and search tools you can call directly. Official site usemagpie.ai, docs at https://usemagpie.ai/docs/start.

What it does

  • One list for every agent: pick any model for any agent and magpie edits the one key that matters in the agent's own config — Claude Code on Kimi, Codex on DeepSeek, Gemini CLI on GLM, OpenCode on your ChatGPT plan
  • Local gateway at 127.0.0.1:3425 speaks OpenAI Chat, OpenAI Responses, Anthropic Messages and Gemini, translating streams, tool calls and reasoning between them; anything with a base URL can point at it
  • Subscription plans you are signed in to (Claude, ChatGPT, Copilot, Gemini or Grok) are discovered from your agents' own sign-ins — Claude Code's files, Codex's files, the Keychain — no key pasting
  • Quota failover: a provider's next account takes over and routing groups move to another model or provider, so the agent never sees the error
  • On-device privacy masking (off by default): keys, passwords and emails are masked before a request leaves your machine and restored in the reply
  • Runs as a macOS, Windows and Linux menu bar app, window, TUI, web UI and CLI, plus Docker and Termux; profiles, magpie quota, and direct image, vision and search tools

When to use it

For developers running more than one agent, provider or account: it consolidates model configs, subscriptions and keys behind one app and one gateway, with failover for quota and stability. The README is blunt — if one agent on its vendor's own plan is enough, you don't need it.

Getting started

# install (macOS builds are signed and notarised; --gui/--tui chooses the flavor):
curl -fsSL https://usemagpie.ai/install.sh | sh

# add a provider, then put any model behind any agent:
magpie provider add deepseek sk-…
magpie claude deepseek/deepseek-v4-pro          # Claude Code on DeepSeek
magpie codex moonshot/kimi-k2.5                 # Codex on Kimi

# also available: go install github.com/yetone/magpie@latest, a Docker image, --proxy/--mirror behind firewalls
# uninstall restores your agents' original configs:
curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall

Things to know

Subscription discovery works by reading your agents' sign-ins — Claude Code's and Codex's files and the Keychain — and that is on by default; turn it off in Settings → Privacy → Subscription accounts, run magpie accounts discovery off, or set MAGPIE_NO_ACCOUNTS=1 for one run. Privacy masking is also off by default: until you enable it, prompts leave your machine unmasked. Failover needs something to fail over to — with one account and no routing group the error reaches the agent. The niche overlaps with config managers like cc-switch and proxies like claude-code-router; magpie's differentiators are the gateway, subscription reuse and quota failover. Releases are published from the separate yetone/magpie-releases repo, and the README thanks Kimi for supporting magpie. MIT. 33,076 stars as of writing (2026-11-10).

Repository

yetone/magpie

Charted

Related on the map

  • The open Agent Skills standard — SKILL.md folders any agent can load, governed by the Agentic AI Foundation since 2026-10-22.

    • official
    • spec
    • agent-skills
    • standard
  • Harness Bridge

    SDK / Tool

    A local launcher that points Claude Code and seven other coding harnesses at any OpenAI-, Anthropic- or Responses-compatible endpoint — without editing a single config file.

    • launcher
    • local-models
    • cli
    • menu-bar
  • Claude for Siri

    SDK / Tool

    Answers macOS Spotlight and Siri prompts with your signed-in Claude Code account — an experimental macOS 27 model-delegation provider.

    • macos
    • siri
    • spotlight
    • model-delegation