Your coding assistants. One place to configure them.
Manage Claude Code and Codex instructions, skills, MCP servers, and hooks from a local interface. Review the diff. Apply when you're ready.
Getting started · Documentation · Contributing · Report a bug
Your assistant setup lives across Markdown, JSON, TOML, and skill directories. Agent Switch brings those files into one workspace while keeping each assistant's native configuration.
- See your setup at a glance. Browse instructions, skills, MCP servers, and hooks; filter by Claude Code or Codex.
- Give each assistant the right instructions. Edit Markdown with a preview, manage Claude rules and Codex overrides, and copy instructions between assistants.
- Keep a shared skill library. Choose which assistants receive each skill, including its supporting files. Disable a skill without losing its folder.
- Review before you write. Changes stay in a draft until you apply them. Inspect diffs and file operations, with backups and conflict detection.
- Bring your setup with you. Export and import configuration as JSON, or use the CLI against the same local service.
 |
 |
| One skill library, explicit assistant targets. | See exactly what changes before applying. |
Screenshots show the running application with fictional data. Reproduce them with the isolated demo.
Requires Node.js 22.12+ and npm. Run from any directory:
npx @ayoub9360/agent-switch@latestThe command starts the local server and opens the app in your browser. No cloning,
manual build, or pnpm installation is needed. The default address is
http://127.0.0.1:4141; if that port is occupied, the launcher chooses a free
one and prints the URL. Stop the server with Ctrl+C.
Agent Switch discovers the global configuration of the account running the server. Edits remain drafts until you review and apply them.
Useful options:
npx @ayoub9360/agent-switch@latest --no-open
npx @ayoub9360/agent-switch@latest --port 4200
npx @ayoub9360/agent-switch@latest --helpSee the CLI reference for commands and configuration options.
For development or the isolated demo, install pnpm 12.8.1 and run:
git clone https://github.com/ayoub9360/agent-switch.git
cd agent-switch
pnpm install --frozen-lockfile
pnpm build
pnpm startOpen http://127.0.0.1:4141.
Want to look around first? After building, run pnpm demo instead of
pnpm start. It uses a temporary home with sample configurations and leaves your
own assistant files alone.
- Discover your existing global configuration.
- Edit instructions, select skill targets, or update MCP and hook settings.
- Review pending changes and the planned file operations.
- Apply to write the native files and create backups.
History keeps the latest 30 revisions. Restoring a revision prepares a draft for another review; it does not immediately overwrite assistant files.
| Capability | Claude Code | Codex |
|---|---|---|
| Instructions | CLAUDE.md and rules/**/*.md |
AGENTS.md and AGENTS.override.md |
| Skills | .claude/skills/ |
.agents/skills/ and .codex/skills/ |
| MCP servers | .claude.json |
.codex/config.toml |
| Hooks | .claude/settings.json |
.codex/config.toml and .codex/hooks.json |
Paths above are relative to your home directory by default. Custom assistant paths are supported. See configuration and file behavior.
Agent Switch currently manages one global configuration. Project-level configurations, multiple profiles, managed administrator settings, plugin contents, and OpenCode integration are not supported. It configures assistants; it does not run chat sessions or switch their models.
The service has access to your assistant configuration. Keep it on localhost or a trusted private network; it has no user authentication. MCP connection tests can start configured commands, and exported configurations can contain secrets. See security before exposing the service or sharing an export.
| I want to… | Read |
|---|---|
| Understand drafts, skills, and the daily workflow | User guide |
| Change paths, ports, or run on a private server | Configuration |
| Use the terminal or package the launcher | CLI reference |
| Resolve a conflict or connection problem | Troubleshooting |
| Work on the code or reproduce screenshots | Development |
| Understand the implementation | Architecture |
Bug reports, documentation improvements, and focused pull requests are welcome. Start with CONTRIBUTING.md for setup, checks, and contribution scope. For feature ideas, open an issue and describe the workflow you want to improve.
MIT. Assistant names and logos belong to their respective owners. Agent Switch is an independent project, not affiliated with or endorsed by Anthropic or OpenAI. See third-party notices.