# ModelSwap

> ModelSwap is an open-source, local-first control plane for managing API keys, models, and provider subscriptions for AI coding agents. One AES-256-GCM encrypted vault lives on your machine; switching the provider or model behind any agent takes one click and only rewrites the fields ModelSwap owns — your hooks, statusLine, and MCP config stay untouched, and every switch saves an automatic snapshot you can roll back. Install with `npm install -g modelswap`, then run `modelswap web` to open the dashboard at http://localhost:3780.

Key facts (verified against the shipped product):
- 41 built-in provider presets: international official APIs, Chinese platforms, aggregators, and local runtimes; Coding Plan / Token Plan subscriptions and pay-as-you-go billing are managed side by side
- 10 agent adapters: Claude Code, ChatGPT Codex, OpenCode, OpenClaw, WorkBuddy, ZCode, Hermes, Kimi Code, Grok, MiMo Code
- 37 provider usage/balance sources queryable directly from the dashboard
- AES-256-GCM encrypted local vault at `~/.modelswap`; multi-device sync via LAN peer-to-peer or self-hosted cloud, end-to-end encrypted — plaintext never leaves your device
- Automatic config snapshots on every switch (last 10 kept per agent) with one-click compare and restore
- Cross-platform: macOS, Linux, Windows. Dashboard UI in Chinese and English.
- Open source (MIT), local-first, free — no account required
- Ships with a CLI and an installable Agent Skill (`modelswap skill`), so other AI agents can call ModelSwap directly
- A browser extension can auto-create API keys inside official provider console pages and file them straight into the vault

## Supported agents

ModelSwap writes each agent's native config files (e.g. `config.toml` + `auth.json` for Codex, `settings.json` for Claude Code):

- [Agent adapters overview (English)](https://modelswap.app/#capabilities)
- [Agent adapters overview (中文)](https://modelswap.app/zh/#capabilities)

The 10 built-in adapters: Claude Code, ChatGPT Codex, OpenCode, OpenClaw, WorkBuddy, ZCode, Hermes, Kimi Code, Grok, MiMo Code.

## Docs

- [User manual (中文)](https://docs.modelswap.app/zh/)
- [User manual (English)](https://docs.modelswap.app/en/)
- [Machine-readable site map for this website](https://modelswap.app/llms-full.txt)

## Product pages

- [Homepage (English)](https://modelswap.app/)
- [Homepage (中文)](https://modelswap.app/zh/)
- [FAQ (English)](https://modelswap.app/#faq)
- [FAQ (中文)](https://modelswap.app/zh/#faq)

## Links

- [GitHub repository (source, MIT license)](https://github.com/Cing-self/modelswap)
- [npm package](https://www.npmjs.com/package/modelswap)