Частые вопросы
Ответы на вопросы, которые возникают при работе с AIM Loadout чаще всего.
Начало работы
Нужен ли GitHub? Можно ли использовать другой Git-хостинг или приватный репозиторий?
GitHub не обязателен. Инвентарь — это обычный Git-репозиторий, и AIM работает с любым Git-хостингом: GitLab, Bitbucket, самостоятельно размещённый Gitea или любой другой. Приватные репозитории поддерживаются — для доступа к ним используйте SSH с настроенным ключом.
Можно ли начать с совершенно пустого репозитория?
Да. Если репозиторий пустой, aiman init создаст внутри него базовую структуру: директории skills/ и mcp/, файлы aim.yaml и .gitignore. Заполнять репозиторий вручную перед инициализацией не нужно. Подробнее: Первый инвентарь.
Что делает aiman init, если репозиторий уже не пустой?
Если репозиторий уже был инициализирован AIM, aiman init подключит его повторно и предложит запустить aiman sync. Если репозиторий содержит чужие файлы навыков, AIM классифицирует их как adoptable — вы сможете привести их к нужному формату. Файлы без корректного frontmatter пропускаются командами aiman apply и aiman sync. Подробнее о формате: Формат инвентаря.
Навыки и инвентарь
Можно ли использовать один инвентарь на нескольких машинах?
Да. Это основной сценарий использования AIM. После aiman push на одной машине выполните aiman init <url> и aiman sync на другой — навыки и MCP-серверы будут применены автоматически. Подробнее: Быстрый старт.
Если у меня несколько AI-инструментов (Claude Code + Cursor) — навык будет применён в оба?
Зависит от поля targets в навыке. Если targets не указан, навык применяется во все обнаруженные на машине AI-среды. Если targets указан (например, только claude-code), навык попадёт только в соответствующую среду. Полный список поддерживаемых значений: Формат инвентаря.
Можно ли скопировать навыки из другого места?
Да. Скопируйте или создайте файлы навыков в директории skills/ вашего инвентаря, затем выполните aiman apply для локального применения и aiman push для публикации. Каждый файл должен соответствовать формату Skill Item — иметь корректный YAML frontmatter с полем name, которое совпадает с именем файла без .md.
Нужно ли перезапускать AI-агент после aiman apply?
Большинство AI-сред читают навыки при старте сессии, не в реальном времени. После aiman apply перезапустите сессию агента, чтобы изменения вступили в силу. Это поведение зависит от конкретной AI-среды.
Конфигурация и среды
Где хранятся секреты (API-ключи для MCP-серверов)? Они попадают в Git?
Нет. Значения секретов хранятся в aim.local.yaml — файле на вашей машине, который AIM автоматически исключает из Git через .gitignore. В репозиторий попадает только описание MCP-сервера с именами переменных и их назначением, но не сами значения. Подробнее: Безопасность и ограничения.
AIM не находит мою AI-среду — что делать?
Запустите aiman doctor — команда покажет, какие среды найдены и по каким путям AIM их ищет. Если среда не найдена, проверьте, что она установлена и что конфигурационная директория существует. Нестандартные пути можно задать вручную в aim.local.yaml. Подробнее: Устранение проблем.
Что такое aim.local.yaml и почему его нельзя коммитить?
aim.local.yaml — локальный конфиг вашей машины: пути AI-сред, hash-метки синхронизации и значения env-переменных MCP-серверов. Этот файл содержит машинно-специфичные данные и секреты, поэтому он не должен попадать в общий репозиторий. AIM создаёт .gitignore с исключением этого файла автоматически при aiman init. Подробнее: Структура репозитория.
Команды
В чём разница между aiman apply и aiman sync?
aiman apply применяет текущее локальное состояние skills/ и mcp/ в AI-среды — без обращения к Git remote. aiman sync сначала получает опубликованное состояние из remote, а затем применяет его локально. Используйте apply в цикле редактирования на одной машине, sync — чтобы подтянуть изменения с другой машины или после aiman push от коллеги.
В чём разница между aiman push и git push?
aiman push — это не просто git push. Команда сначала валидирует инвентарь, затем создаёт commit с управляемыми файлами и только потом выполняет push. Отдельно запускать git add, git commit и git push не нужно — aiman push делает всё это за вас.
Почему aiman push заблокировался? Что значит «remote новее»?
aiman push останавливается, если remote содержит коммиты, которых нет локально. Это означает, что кто-то другой (или вы с другой машины) опубликовал изменения после вашей последней синхронизации. Выполните aiman sync, чтобы применить актуальное состояние, а затем повторите aiman push.
Другое
Можно ли иметь несколько репозиториев инвентаря?
Да. Для переключения между ними используйте aiman switch <path> — команда переключает активный репозиторий без повторного клонирования. Глобальный конфиг AIM хранит путь к текущему активному репозиторию.
AIM Loadout платный?
Нет. AIM Loadout — open source проект, распространяется под лицензией Apache 2.0.