AI-среды

AIM применяет один инвентарь в разные AI-среды через адаптеры.

Поддерживаемые среды

Среда	Target ID	Навыки	MCP config
Claude Code	claude-code	поддержано	поддержано
Cursor	cursor	поддержано	поддержано
Codex CLI	codex	поддержано	поддержано

Все три адаптера работают в обе стороны: устанавливают элементы инвентаря в среду и читают её содержимое при импорте (aiman import skill, aiman import mcp). Пути, из которых читаются навыки и MCP-конфигурация, перечислены в Справочнике CLI.

Gemini CLI и другие среды рассматриваются как будущие адаптеры.

Как AIM выбирает путь

При aiman init и aiman doctor AIM пытается найти стандартные директории AI-сред.

Если среда не найдена автоматически, путь можно задать в aim.local.yaml:

environments:
  claude-code: ~/.claude
  cursor: ~/.cursor
  codex: ~/.codex

aim.local.yaml локален для машины и не должен попадать в Git.

Навыки

Навык из skills/<name>.md (или папочный навык skills/<name>/SKILL.md вместе с ресурсными файлами) устанавливается в формат конкретной AI-среды. AIM делает это при apply (локальная итерация) и при sync (применение опубликованного состояния):

aiman apply   # применить локальные изменения
aiman sync    # применить опубликованное состояние из Git

MCP-серверы

MCP Item из mcp/<name>.yaml применяется адаптером в config-файл AI-среды.

Для Claude Code и Cursor используется JSON-структура mcpServers. Для Codex CLI используется TOML-структура mcp_servers.

Значения секретов и env-переменных подставляются из локального aim.local.yaml.

Диагностика

aiman doctor

doctor показывает:

• найденные и отсутствующие AI-среды;
• проблемы с путями;
• состояние репозитория инвентаря;
• валидность навыков в skills/ активного репозитория инвентаря;
• отсутствующие обязательные MCP env-переменные.

doctor проверяет только наличие базовых директорий сред. Он не сканирует, какие навыки установлены внутри AI-сред: секция === Skills === считает навыки в репозитории инвентаря.

---

Дальше

• Концепции — что такое адаптер, Skill Item и MCP Item.
• Безопасность и ограничения — что AIM пишет в AI-среды.
• Устранение проблем — если среда не найдена или путь нестандартный.