Adapter Reference

An adapter encapsulates the format of a specific AI environment.

Summary

AI environment	Target ID	Default base dir	Skills	MCP config
Claude Code	claude-code	~/.claude	skills/<name>/SKILL.md	settings.json
Cursor	cursor	~/.cursor	skills/<name>/SKILL.md	mcp.json
Codex CLI	codex	~/.codex	skills/<name>/SKILL.md	config.toml

Claude Code

MCP servers are written to the mcpServers JSON section:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"],
      "env": {
        "API_KEY": "..."
      }
    }
  }
}

Cursor

Cursor uses the mcpServers JSON format in mcp.json.

The entry structure is the same as for Claude Code.

Codex CLI

Codex CLI uses TOML:

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

[mcp_servers.context7.env]
API_KEY = "..."

Overriding paths

If an environment is installed in a non-standard location, set the base dir in aim.local.yaml:

environments:
  claude-code: /custom/path/.claude

The adapter itself knows where skills and the MCP config are located within the base dir.