Every agent's model. One place. Codex on DeepSeek, Claude Code on Kimi, from the menu bar.

★ 37,354⑂ 3,361👁 43⑃ 572● 6,199▤ 2,913
GoMITCreated 2026-09-23usemagpie.ai
More from this author
Download: magpie v0.1.4273magpie-0.1.4273 ↓0.1.42732026-11-15
+662
Daily
+4,552
Weekly
37,354
stars
3,361
forks
43
watchers
572
prs
6,199
issues
2,913
releases

README

magpie

 Every agent's model. One place.

Claude Code on Kimi. Codex on DeepSeek. Gemini CLI on GLM. OpenCode on your ChatGPT plan.
Switch any of them from the menu bar. One local gateway serves them all,
and when a quota runs out, it quietly moves on to your next account.

   
!macOS !Windows !Linux !Docker !Termux

Thanks to Kimi for supporting magpie and the open source community.

Sponsors

  
  


Download  ·  Docs  ·  Reference  ·  Plugins  ·  Discord  ·  English · 简体中文




  
  






 Is magpie for you?

Each agent keeps its model in its own file, in its own format, with its own keys and base URLs. 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. magpie edits the one key that matters in the agent's own config.
- Use one provider everywhere: an API key, a local model, or the Claude, ChatGPT, Copilot, Gemini or Grok plan you're signed in to.
- Keep going 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 there is nothing to move to, and the error reaches the agent.
- Keep your secrets off the vendor's servers: once you turn masking on in Settings → Privacy (it's off by default), keys, passwords and emails in a prompt are masked on your computer before the request leaves it, and put back in the reply.

It's for you if you use more than one agent, more than one provider, or more than one account. If you use one agent on its vendor's own plan and that's enough, you don't need it.

Runs on macOS, Windows and Linux (menu bar app, window, TUI, web UI and CLI), in Docker, and on Termux.

 Quick start

1 · Install. Download the app from usemagpie.ai, or run:

sh
curl -fsSL https://usemagpie.ai/install.sh | sh


Mac builds are signed and notarised, every release file carries a GitHub Actions build attestation (gh attestation verify  -R yetone/magpie-releases), and every build updates itself. On Linux the script installs the desktop app, and on a desktop without WebKitGTK 4.1 installs it first with your package manager (sudo asks for your password); with no desktop, or no terminal to ask at, it installs the terminal build and says which package to add. --gui or --tui chooses. Behind a firewall, use --proxy or --mirror. Or go install github.com/yetone/magpie@latest, or the Docker image. Remove magpie with curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall: it puts your agents back as they were, then takes off what the script installed (with magpie deleted already, it downloads one to put them back); your settings in ~/.config/magpie stay unless you add --purge.

2 · Add a provider. Open magpie and go to Providers → Add provider. Pick a preset and paste a key, or sign in with a subscription.

3 · Pick a model for ea

Top issues

Latest release

magpie v0.1.4273 v0.1.4273 2026-11-15
Changes

- The Antigravity plugin remains available to existing users but is no longer offered to new users.

 Install

Download from usemagpie.ai, or curl -fsSL https://usemagpie.ai/install.sh | sh. An installed magpie updates itself.

- macOS (Apple Silicon): magpie-darwin-arm64.dmg
- macOS (Intel): magpie-darwin-amd64.dmg
- Windows: magpie-windows-amd64.exe (ARM: magpie-windows-arm64.exe)
- Linux: magpie-linux-amd64 / magpie-linux-arm64 (needs GTK 3 and WebKitGTK 4.1)
- Terminal only: magpie-cli--



 Changes

- Antigravity 插件仍可供现有用户使用,但不再向新用户提供。

 安装

从 usemagpie.ai 下载,或运行 curl -fsSL https

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON