# clients.dev

> An open, machine-readable database of how AI coding clients (Cursor, Claude Code, Codex, …) are configured: for every client and every config surface, the exact file paths (project/global/enterprise), formats, and typed fields — verified from official vendor docs.

Surfaces: mcp (Model Context Protocol servers — tools, resources, and prompts.); skills (Reusable SKILL.md instruction sets the agent can load on demand.); rules (Persistent instructions and memory files loaded into context.); hooks (Scripts that observe or gate the agent loop around lifecycle events.); commands (User-invocable slash commands and custom prompts.); settings (The primary configuration file for client behavior and permissions.)

## API

- [Full catalog](https://clients.dev/api/catalog.json): every client, every surface, one JSON document
- [Single client](https://clients.dev/api/clients/cursor.json): replace `cursor` with any client id below
- [Surface comparison](https://clients.dev/api/mcp.json): one surface across all clients (mcp, skills, rules, hooks, commands, settings)
- [JSON Schemas](https://clients.dev/api/schemas.json): validate/generate config entries per client per surface
- MCP server (Streamable HTTP): https://clients.dev/api/mcp — tools: list_clients, get_client, compare_surface, get_config_schema

## Fully documented clients

- [Amp](https://clients.dev/api/clients/amp.json): mcp: ~/.config/amp/settings.json, .amp/settings.json, .agents/skills/<name>/mcp.json | skills: .agents/skills/<name>/SKILL.md, ~/.config/agents/skills/<name>/SKILL.md, .claude/skills/<name>/SKILL.md | rules: AGENTS.md, ~/.config/amp/AGENTS.md, /etc/ampcode/AGENTS.md | hooks: .amp/plugins/*.ts, ~/.config/amp/plugins/*.ts | commands: .agents/commands/<name>.md, ~/.config/amp/commands/<name>.md | settings: ~/.config/amp/settings.json, .amp/settings.json, /etc/ampcode/managed-settings.json
- [Claude Code](https://clients.dev/api/clients/claude-code.json): mcp: .mcp.json, ~/.claude.json | skills: .claude/skills/<name>/SKILL.md, ~/.claude/skills/<name>/SKILL.md | rules: CLAUDE.md, .claude/rules/*.md, ~/.claude/CLAUDE.md, /Library/Application Support/ClaudeCode/CLAUDE.md | hooks: .claude/settings.json, ~/.claude/settings.json | commands: .claude/commands/<name>.md, ~/.claude/commands/<name>.md | settings: .claude/settings.json, .claude/settings.local.json, ~/.claude/settings.json, managed-settings.json
- [Cline](https://clients.dev/api/clients/cline.json): mcp: ~/.cline/data/settings/cline_mcp_settings.json, ~/.cline/mcp.json, .cline/mcp.json | skills: .cline/skills/<name>/SKILL.md, ~/.cline/skills/<name>/SKILL.md | rules: .clinerules/, AGENTS.md, ~/Documents/Cline/Rules/, ~/.agents/AGENTS.md | hooks: .clinerules/hooks/<EventName>, ~/Documents/Cline/Hooks/<EventName> | commands: .clinerules/workflows/*.md, ~/Documents/Cline/Workflows/*.md | settings: ~/.cline/data/settings/global-settings.json, ~/.cline/data/settings/providers.json, .cline/
- [Codex](https://clients.dev/api/clients/codex.json): mcp: ~/.codex/config.toml, .codex/config.toml | skills: .agents/skills/<name>/SKILL.md, ~/.agents/skills/<name>/SKILL.md, /etc/codex/skills/<name>/SKILL.md | rules: AGENTS.md, ~/.codex/AGENTS.md | hooks: ~/.codex/config.toml, .codex/config.toml | settings: ~/.codex/config.toml, .codex/config.toml, requirements.toml
- [Crush](https://clients.dev/api/clients/crush.json): mcp: crush.json, ~/.config/crush/crush.json | skills: .crush/skills/<name>/SKILL.md, ~/.config/crush/skills/<name>/SKILL.md | rules: AGENTS.md, CRUSH.md, ~/.config/crush/CRUSH.md, ~/.config/AGENTS.md | hooks: crush.json, ~/.config/crush/crush.json | commands: .crush/commands/<name>.md, ~/.config/crush/commands/<name>.md, ~/.crush/commands/<name>.md | settings: .crush.json, crush.json, ~/.config/crush/crush.json
- [Cursor](https://clients.dev/api/clients/cursor.json): mcp: .cursor/mcp.json, ~/.cursor/mcp.json | skills: .cursor/skills/<name>/SKILL.md, .agents/skills/<name>/SKILL.md, ~/.cursor/skills/<name>/SKILL.md, ~/.agents/skills/<name>/SKILL.md | rules: .cursor/rules/*.mdc, AGENTS.md | hooks: .cursor/hooks.json, ~/.cursor/hooks.json, /Library/Application Support/Cursor/hooks.json | settings: .cursor/permissions.json, ~/.cursor/permissions.json
- [Droid](https://clients.dev/api/clients/droid.json): mcp: ~/.factory/mcp.json, .factory/mcp.json | skills: .factory/skills/<name>/SKILL.md, ~/.factory/skills/<name>/SKILL.md, .agent/skills/<name>/SKILL.md | rules: AGENTS.md, ~/.factory/AGENTS.md | hooks: .factory/hooks.json, ~/.factory/hooks.json, ~/.factory/settings.json | commands: .factory/commands/<name>.md, ~/.factory/commands/<name>.md | settings: ~/.factory/settings.json, .factory/settings.json
- [Gemini CLI](https://clients.dev/api/clients/gemini-cli.json): mcp: .gemini/settings.json, ~/.gemini/settings.json | skills: .gemini/skills/<name>/SKILL.md, .agents/skills/<name>/SKILL.md, ~/.gemini/skills/<name>/SKILL.md, ~/.agents/skills/<name>/SKILL.md | rules: GEMINI.md, ~/.gemini/GEMINI.md | hooks: .gemini/settings.json, ~/.gemini/settings.json, /etc/gemini-cli/settings.json | commands: .gemini/commands/<name>.toml, ~/.gemini/commands/<name>.toml | settings: .gemini/settings.json, ~/.gemini/settings.json, /etc/gemini-cli/settings.json, /etc/gemini-cli/system-defaults.json
- [GitHub Copilot](https://clients.dev/api/clients/github-copilot.json): skills: .github/skills/<name>/SKILL.md, .claude/skills/<name>/SKILL.md, .agents/skills/<name>/SKILL.md | rules: .github/copilot-instructions.md, .github/instructions/**/*.instructions.md, AGENTS.md, CLAUDE.md | hooks: .github/hooks/*.json | commands: not supported | settings: .github/workflows/copilot-setup-steps.yml, .github/copilot/settings.json
- [GitHub Copilot CLI](https://clients.dev/api/clients/github-copilot-cli.json): mcp: ~/.copilot/mcp-config.json, .mcp.json, .github/mcp.json | skills: .github/skills/<name>/SKILL.md, .agents/skills/<name>/SKILL.md, .claude/skills/<name>/SKILL.md, ~/.copilot/skills/<name>/SKILL.md, ~/.agents/skills/<name>/SKILL.md | rules: .github/copilot-instructions.md, .github/instructions/**/*.instructions.md, AGENTS.md, ~/.copilot/copilot-instructions.md, ~/.copilot/instructions/*.instructions.md | hooks: .github/hooks/*.json, ~/.copilot/hooks/*.json, .github/copilot/settings.json, ~/.copilot/settings.json, /etc/github-copilot/policy.d/*.json | commands: .claude/commands/<name>.md | settings: ~/.copilot/settings.json, .github/copilot/settings.json, .github/copilot/settings.local.json, /Library/Application Support/GitHubCopilot/managed-settings.json
- [Goose](https://clients.dev/api/clients/goose.json): mcp: ~/.config/goose/config.yaml | skills: .agents/skills/<name>/SKILL.md, ~/.agents/skills/<name>/SKILL.md, ~/.agents/plugins/<plugin-name>/ | rules: ~/.config/goose/.goosehints, .goosehints, AGENTS.md, ~/.config/goose/AGENTS.md | hooks: ~/.agents/plugins/<plugin-name>/hooks/hooks.json, .agents/plugins/<plugin-name>/hooks/hooks.json | commands: ~/.config/goose/config.yaml | settings: ~/.config/goose/config.yaml
- [Kilo Code](https://clients.dev/api/clients/kilo.json): mcp: .kilo/kilo.jsonc, kilo.jsonc, ~/.config/kilo/kilo.jsonc | skills: .kilo/skills/<name>/SKILL.md, ~/.kilo/skills/<name>/SKILL.md, .agents/skills/<name>/SKILL.md, .claude/skills/<name>/SKILL.md | rules: AGENTS.md, .kilo/rules/*.md, kilo.jsonc, ~/.config/kilo/AGENTS.md, ~/.config/kilo/kilo.jsonc | hooks: not supported | commands: .kilo/commands/<name>.md, ~/.config/kilo/commands/<name>.md | settings: ~/.config/kilo/kilo.jsonc, .kilo/kilo.jsonc, kilo.jsonc
- [OpenCode](https://clients.dev/api/clients/opencode.json): mcp: opencode.json, ~/.config/opencode/opencode.json | skills: .opencode/skills/<name>/SKILL.md, ~/.config/opencode/skills/<name>/SKILL.md, .claude/skills/<name>/SKILL.md, ~/.claude/skills/<name>/SKILL.md, .agents/skills/<name>/SKILL.md, ~/.agents/skills/<name>/SKILL.md | rules: AGENTS.md, ~/.config/opencode/AGENTS.md, CLAUDE.md, ~/.claude/CLAUDE.md, opencode.json | hooks: .opencode/plugins/, ~/.config/opencode/plugins/, opencode.json | commands: .opencode/commands/<name>.md, ~/.config/opencode/commands/<name>.md, opencode.json | settings: opencode.json, ~/.config/opencode/opencode.json, /Library/Application Support/opencode/opencode.json, tui.json
- [Qwen Code](https://clients.dev/api/clients/qwen-code.json): mcp: .qwen/settings.json, ~/.qwen/settings.json | skills: .qwen/skills/<name>/SKILL.md, ~/.qwen/skills/<name>/SKILL.md | rules: QWEN.md, .qwen/QWEN.local.md, ~/.qwen/QWEN.md, .qwen/team-memory/ | hooks: .qwen/settings.json, ~/.qwen/settings.json | commands: .qwen/commands/<name>.md, ~/.qwen/commands/<name>.md | settings: .qwen/settings.json, ~/.qwen/settings.json, /etc/qwen-code/settings.json, /etc/qwen-code/system-defaults.json
- [Roo Code](https://clients.dev/api/clients/roo.json): mcp: .roo/mcp.json, mcp_settings.json | skills: .roo/skills/<name>/SKILL.md, .agents/skills/<name>/SKILL.md, ~/.roo/skills/<name>/SKILL.md, ~/.agents/skills/<name>/SKILL.md | rules: .roo/rules/, .roo/rules-{modeSlug}/, .roorules, AGENTS.md, ~/.roo/rules/, ~/.roo/rules-{modeSlug}/ | hooks: not supported | commands: .roo/commands/<name>.md, ~/.roo/commands/<name>.md | settings: .vscode/settings.json, ~/Documents/roo-code-settings.json
- [Visual Studio Code](https://clients.dev/api/clients/vscode.json): mcp: .vscode/mcp.json, <VS Code profile>/mcp.json | skills: .github/skills/<name>/SKILL.md, .claude/skills/<name>/SKILL.md, .agents/skills/<name>/SKILL.md, ~/.copilot/skills/<name>/SKILL.md, ~/.claude/skills/<name>/SKILL.md, ~/.agents/skills/<name>/SKILL.md | rules: .github/copilot-instructions.md, AGENTS.md, CLAUDE.md, .github/instructions/**/*.instructions.md, .claude/rules/*.md, ~/.copilot/instructions/*.instructions.md | hooks: .github/hooks/*.json, .claude/settings.json, ~/.copilot/hooks/*.json, ~/.claude/settings.json | commands: .github/prompts/<name>.prompt.md, <VS Code profile>/prompts/<name>.prompt.md | settings: .vscode/settings.json, <VS Code profile>/settings.json
- [Warp](https://clients.dev/api/clients/warp.json): mcp: ~/.warp/.mcp.json, .warp/.mcp.json | skills: .agents/skills/<name>/SKILL.md, ~/.agents/skills/<name>/SKILL.md, .warp/skills/<name>/SKILL.md, ~/.warp/skills/<name>/SKILL.md | rules: AGENTS.md, WARP.md | hooks: not supported | settings: ~/.warp/settings.toml
- [Windsurf](https://clients.dev/api/clients/windsurf.json): mcp: ~/.codeium/windsurf/mcp_config.json | skills: .windsurf/skills/<name>/SKILL.md, ~/.codeium/windsurf/skills/<name>/SKILL.md, /etc/windsurf/skills/<name>/SKILL.md | rules: .windsurf/rules/*.md, .windsurfrules, AGENTS.md, ~/.codeium/windsurf/memories/global_rules.md, /etc/windsurf/rules/*.md | hooks: .windsurf/hooks.json, ~/.codeium/windsurf/hooks.json, /etc/windsurf/hooks.json | commands: .windsurf/workflows/*.md, ~/.codeium/windsurf/global_workflows/*.md, /etc/windsurf/workflows/*.md | settings: /etc/windsurf/policies/policy.json
- [Zed](https://clients.dev/api/clients/zed.json): mcp: ~/.config/zed/settings.json, .zed/settings.json | skills: .agents/skills/<name>/SKILL.md, ~/.agents/skills/<name>/SKILL.md | rules: ~/.config/zed/AGENTS.md, AGENTS.md, .rules | hooks: not supported | commands: .agents/skills/<name>/SKILL.md, ~/.agents/skills/<name>/SKILL.md | settings: ~/.config/zed/settings.json, .zed/settings.json

## Partially documented clients

- [AdaL](https://clients.dev/api/clients/adal.json): skills
- [AiderDesk](https://clients.dev/api/clients/aider-desk.json): skills
- [Antigravity](https://clients.dev/api/clients/antigravity.json): mcp, skills
- [Antigravity CLI](https://clients.dev/api/clients/antigravity-cli.json): skills
- [AstrBot](https://clients.dev/api/clients/astrbot.json): skills
- [Augment](https://clients.dev/api/clients/augment.json): skills
- [Autohand Code CLI](https://clients.dev/api/clients/autohand-code.json): skills
- [Claude Desktop](https://clients.dev/api/clients/claude-desktop.json): mcp
- [Cline CLI](https://clients.dev/api/clients/cline-cli.json): mcp
- [Code Studio](https://clients.dev/api/clients/codestudio.json): skills
- [CodeArts Agent](https://clients.dev/api/clients/codearts-agent.json): skills
- [CodeBuddy](https://clients.dev/api/clients/codebuddy.json): skills
- [Codemaker](https://clients.dev/api/clients/codemaker.json): skills
- [Command Code](https://clients.dev/api/clients/command-code.json): skills
- [Continue](https://clients.dev/api/clients/continue.json): skills
- [Cortex Code](https://clients.dev/api/clients/cortex.json): skills
- [Deep Agents](https://clients.dev/api/clients/deepagents.json): skills
- [Devin for Terminal](https://clients.dev/api/clients/devin.json): skills
- [Dexto](https://clients.dev/api/clients/dexto.json): skills
- [Eve](https://clients.dev/api/clients/eve.json): skills
- [Firebender](https://clients.dev/api/clients/firebender.json): skills
- [ForgeCode](https://clients.dev/api/clients/forgecode.json): skills
- [Hermes Agent](https://clients.dev/api/clients/hermes-agent.json): skills
- [IBM Bob](https://clients.dev/api/clients/bob.json): skills
- [iFlow CLI](https://clients.dev/api/clients/iflow-cli.json): skills
- [inference.sh](https://clients.dev/api/clients/inference-sh.json): skills
- [Jazz](https://clients.dev/api/clients/jazz.json): skills
- [Junie](https://clients.dev/api/clients/junie.json): skills
- [Kimi Code CLI](https://clients.dev/api/clients/kimi-code-cli.json): skills
- [Kiro CLI](https://clients.dev/api/clients/kiro-cli.json): skills
- [Kode](https://clients.dev/api/clients/kode.json): skills
- [Lingma](https://clients.dev/api/clients/lingma.json): skills
- [Loaf](https://clients.dev/api/clients/loaf.json): skills
- [MCPJam](https://clients.dev/api/clients/mcpjam.json): skills
- [MCPorter](https://clients.dev/api/clients/mcporter.json): mcp
- [Mistral Vibe](https://clients.dev/api/clients/mistral-vibe.json): skills
- [Moxby](https://clients.dev/api/clients/moxby.json): skills
- [Mux](https://clients.dev/api/clients/mux.json): skills
- [Neovate](https://clients.dev/api/clients/neovate.json): skills
- [Ona](https://clients.dev/api/clients/ona.json): skills
- [OpenClaw](https://clients.dev/api/clients/openclaw.json): skills
- [OpenHands](https://clients.dev/api/clients/openhands.json): skills
- [Pi](https://clients.dev/api/clients/pi.json): skills
- [Pochi](https://clients.dev/api/clients/pochi.json): skills
- [PromptScript](https://clients.dev/api/clients/promptscript.json): skills
- [Qoder](https://clients.dev/api/clients/qoder.json): skills
- [Qoder CN](https://clients.dev/api/clients/qoder-cn.json): skills
- [Reasonix](https://clients.dev/api/clients/reasonix.json): skills
- [Replit](https://clients.dev/api/clients/replit.json): skills
- [Rovo Dev](https://clients.dev/api/clients/rovodev.json): skills
- [Tabnine CLI](https://clients.dev/api/clients/tabnine-cli.json): skills
- [Terramind](https://clients.dev/api/clients/terramind.json): skills
- [Tinycloud](https://clients.dev/api/clients/tinycloud.json): skills
- [Trae](https://clients.dev/api/clients/trae.json): skills
- [Trae CN](https://clients.dev/api/clients/trae-cn.json): skills
- [Zencoder](https://clients.dev/api/clients/zencoder.json): skills
- [Zenflow](https://clients.dev/api/clients/zenflow.json): skills

## Contributing

- [GitHub](https://github.com/agent-tooling/clients-dev): data is plain TOML under configs/<client-id>/, one file per surface; PRs welcome, official docs only