Справочник конфигурации

AIM использует три уровня конфигурации:

• глобальный конфиг пользователя;
• общий конфиг репозитория инвентаря;
• локальный конфиг конкретной машины.

Глобальный конфиг

Путь:

~/.config/aim/config.yaml

Назначение:

• хранить путь к активному репозиторию инвентаря;
• позволять запускать aiman status, aiman sync, aiman push из любой директории;
• в будущем хранить пользовательские настройки вроде editor.

Пример:

repo: /home/alex/aim-loadout

Пишется командами aiman init и aiman switch.

aim.yaml

Путь:

<inventory>/aim.yaml

Хранится в Git и одинаков для всех машин.

Пример, создаваемый aiman init:

skill_paths: {}

skill_paths зарезервирован для будущей кастомизации путей установки навыков. В текущей версии адаптеры используют пути по умолчанию и переопределения из aim.local.yaml.

Используйте aim.yaml только для настроек, которые должны быть общими для всех пользователей этого репозитория инвентаря.

aim.local.yaml

Путь:

<inventory>/aim.local.yaml

Не хранится в Git. Создаётся на каждой машине.

Пример:

repo: git@github.com:you/aim-loadout.git
synced_hash: abc1234
published_hash: abc1234

adapters:
  claude_code:
    base_dir: /home/alex/.claude
  cursor:
    base_dir: /home/alex/.cursor
  codex:
    base_dir: /home/alex/.codex

mcp_env:
  context7.UPSTASH_REDIS_REST_URL: https://example.upstash.io

repo (в aim.local.yaml)

URL Git-репозитория инвентаря, подключённого на этой машине. Записывается автоматически командой aiman init. Не редактируйте вручную.

adapters

Переопределяет путь к конфигурационной директории AI-среды на текущей машине. Используйте только если AI-среда установлена по нестандартному пути.

Если секция не задана, AIM определяет пути автоматически: Claude Code — ~/.claude, Cursor — ~/.cursor, Codex CLI — ~/.codex. На Linux ~ раскрывается в /home/<user>, на macOS — в /Users/<user>, на Windows — в C:\Users\<user>.

Ключи адаптеров: claude_code, cursor, codex. Каждый принимает поле base_dir.

mcp_env

Хранит локальные значения env-переменных MCP-серверов. Ключи имеют формат <server-name>.<VAR_NAME>.

Эти значения могут быть секретами. Файл aim.local.yaml должен быть в .gitignore.

published_hash и synced_hash

published_hash — последний commit, успешно опубликованный с этой машины через aiman push.

synced_hash — последний commit, полностью применённый в AI-среды через aiman sync.

Эти hash-метки помогают объяснять состояние инвентаря, но не заменяют состояние Git как источник истины для защитных проверок.