Справочник адаптеров

Адаптер инкапсулирует формат конкретной AI-среды.

Сводная таблица

AI-среда	Target ID	Base dir по умолчанию	Навыки	MCP config
Claude Code	claude-code	~/.claude	skills/<name>/SKILL.md	~/.claude.json
Cursor	cursor	~/.cursor	skills/<name>/SKILL.md	mcp.json
Codex CLI	codex	~/.codex	skills/<name>/SKILL.md	config.toml

Claude Code

MCP-сервер записывается в ~/.claude.json, в JSON-секцию mcpServers — это файл, из которого Claude Code читает определения MCP-серверов (не settings.json: там только политики вроде allowedMcpServers):

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

Cursor

Cursor использует JSON-формат mcpServers в mcp.json.

Структура записи такая же, как у Claude Code.

Cursor может создать ~/.cursor/mcp.json заранее как пустой файл. AIM трактует пустой файл как пустой объект {} — установка MCP-серверов продолжается корректно.

Codex CLI

Codex CLI использует TOML:

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

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

Чтение среды при импорте

Адаптер умеет не только писать в среду, но и читать её при aiman import skill и aiman import mcp.

AI-среда	Откуда читаются навыки	Откуда читается MCP-конфигурация
Claude Code	~/.claude/skills/<name>/SKILL.md и плоские ~/.claude/skills/*.md (плоский файл приоритетнее)	~/.claude.json, затем ~/.claude/settings.json для имён, которых там нет
Cursor	~/.cursor/skills/<name>/SKILL.md	~/.cursor/mcp.json
Codex CLI	~/.codex/skills/<name>/SKILL.md	~/.codex/config.toml

Импортируются только stdio-серверы — те, у которых задан command. Записи с "type": "http", "type": "sse" или голым "url" адаптер в инвентарь не отдаёт: aiman import mcp <name> для такого сервера завершается ошибкой с причиной (справочник CLI).

Удаление элементов из среды

Адаптер умеет не только устанавливать элементы, но и удалять их. Удаление выполняется только командой aiman apply --loadout <name> и только для элементов, известных инвентарю (справочник CLI).

Что удаляется	Как
Навык	удаляется директория <base dir>/skills/<name>/ целиком, вместе со справочными файлами
MCP-сервер	из конфигурации среды убирается только запись этого сервера; остальные записи и сам файл сохраняются

Для Claude Code запись удаляется из ~/.claude.json — того же файла, в который она была установлена. Если записи или файла нет, удаление проходит без ошибки.

Переопределение путей

Если среда установлена нестандартно, задайте base dir в aim.local.yaml:

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

Адаптер сам знает, где внутри base dir находятся навыки и MCP config.