Agent Config Bridge
Convert CLAUDE.md, AGENTS.md, Cursor rules, GEMINI.md and MCP configs between coding agents.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
https://github.com/onehumanbeing/agent-config-bridge/releases/download/v0.1.0/agent-config-bridge-0.1.0.mcpbDocumentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
agent-config-bridge
An MCP server that moves your coding-agent setup between Claude Code, Codex CLI, Cursor and Gemini CLI: instruction files (CLAUDE.md, AGENTS.md, .cursor/rules/*.mdc, .cursorrules, GEMINI.md) and MCP server configs (mcpServers JSON ⇄ Codex config.toml ⇄ Gemini settings.json).
Runs locally over stdio. No network calls, no telemetry. It writes files only when you call migrate_project with write: true.
Prefer a web UI? Use the same converter in your browser at getaicodingagent.com.
Tools
| Tool | What it does |
|---|---|
convert_rules | Instruction text from one tool → files and paths for the others. Can also share one AGENTS.md through a symlink or an @AGENTS.md import |
convert_mcp_config | MCP servers: Claude Code / Claude Desktop / Cursor JSON ⇄ Codex [mcp_servers.*] TOML ⇄ Gemini httpUrl/url |
detect_agent_configs | Scans a project read-only for every agent config file and skills folder, and lists which tools have no config yet |
migrate_project | Generates the missing configs from the existing ones. Dry run by default. Existing files are skipped unless overwrite: true; .gemini/settings.json is merged |
compat_matrix | Where each tool reads its config, with official doc links and a verified date. Anything the official docs don't state is returned as unknown |
Install
You need Node.js 18 or later and npm 10 or later (npm 9.2 fails to run GitHub packages through npx). The package is not on npm. Run it straight from GitHub (dist/ is committed, so there's no build step):
npx -y github:onehumanbeing/agent-config-bridge
Claude Code
claude mcp add agent-config-bridge -- npx -y github:onehumanbeing/agent-config-bridge
Codex CLI
codex mcp add agent-config-bridge -- npx -y github:onehumanbeing/agent-config-bridge
or add this to ~/.codex/config.toml:
[mcp_servers.agent-config-bridge]
command = "npx"
args = ["-y", "github:onehumanbeing/agent-config-bridge"]
Cursor: .cursor/mcp.json (project) or ~/.cursor/mcp.json (global). Gemini CLI: .gemini/settings.json or ~/.gemini/settings.json:
{ "mcpServers": { "agent-config-bridge": { "command": "npx", "args": ["-y", "github:onehumanbeing/agent-config-bridge"] } } }
MCPB bundle: download agent-config-bridge-0.1.0.mcpb from the v0.1.0 release and open it in an MCPB-compatible client (for example, double-click it to install in Claude Desktop). Dependencies are bundled.
From a clone
git clone https://github.com/onehumanbeing/agent-config-bridge && cd agent-config-bridge
claude mcp add agent-config-bridge -- node "$PWD/dist/index.js"
MCP Registry name: io.github.onehumanbeing/agent-config-bridge
Example prompts
- "Detect the agent configs in this repo and migrate them to Codex and Cursor (dry run first)."
- "Convert this Claude Desktop config to Codex TOML."
- "Where does Gemini CLI read its MCP config? Use compat_matrix."
Links
- Web converter and compatibility table: https://getaicodingagent.com
- Config matrix for 17 agents: https://getaicodingagent.com/config/
- Compare coding agents: https://getaicodingagent.com/compare
Develop
npm install && npm test # builds, then runs unit tests plus an MCP client smoke test
MIT © onehumanbeing
Frequently asked questions
What is Agent Config Bridge?
Convert CLAUDE.md, AGENTS.md, Cursor rules, GEMINI.md and MCP configs between coding agents.
How do I install Agent Config Bridge?
Follow the installation steps in its documentation, shown on this page and in its repository.
Does Agent Config Bridge need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Agent Config Bridge open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Agent Config Bridge?
It is published by onehumanbeing. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.