Устранение проблем

Проверить общее состояние

aiman status
aiman doctor

status отвечает на вопрос «что изменено и что опубликовано». doctor отвечает на вопрос «готова ли локальная машина применять инвентарь».

AI-среда не найдена

Симптом:

environment codex not found

Что сделать:

1. Убедитесь, что AI-инструмент установлен.
2. Проверьте стандартную директорию среды.
3. Если путь нестандартный, задайте его в aim.local.yaml.

environments:
  codex: ~/.codex

aiman sync блокируется из-за локальных изменений

aiman sync не затирает локальные изменения без явного решения пользователя.

Варианты:

• опубликовать изменения:

aiman push
aiman sync

• вручную сохранить или удалить локальные изменения;
• применить опубликованное состояние с потерей локальных изменений:

aiman sync --force

Удалённый репозиторий новее локального состояния

Если push сообщает, что удалённый репозиторий ушёл вперёд, сначала примените опубликованное состояние:

aiman sync

После этого повторите локальные правки или опубликуйте актуальное состояние.

Не задана обязательная MCP env-переменная

Симптом:

required env variable API_KEY is missing

Запустите aiman sync — AIM запросит значение интерактивно. Или задайте значение напрямую в aim.local.yaml:

mcp_env:
  context7:
    API_KEY: "..."

Не коммитьте aim.local.yaml.

Невалидный Skill или MCP Item

Проверьте:

• имя файла совпадает с name;
• Skill имеет непустое тело после frontmatter;
• MCP Item содержит name, description, command, args, targets, env;
• YAML валиден.

Форматы описаны в Формате инвентаря.

Нет доступа к удалённому репозиторию

Проверьте:

• SSH-ключ или HTTPS-аутентификацию;
• права доступа к репозиторию;
• наличие remote origin;
• сетевое соединение.

История Git разошлась

AIM намеренно не выполняет merge за пользователя.

Если история разошлась, восстановите репозиторий стандартными Git-командами вручную, затем повторите:

aiman status
aiman sync