Адаптеры окружений

Apothem поставляется с семнадцатью встроенными адаптерами окружений. Каждый адаптер преобразует одни и те же общие группы в нативные файлы платформы там, где платформа их поддерживает, и в принадлежащие Apothem вспомогательные деревья там, где она их не поддерживает.

Поддерживаемые окруженияCopy Anchor Link

Реестр поддерживаемых содержит ровно семнадцать адаптеров. Используйте эти точные имена установки с --harness или используйте all для детерминированного набора реестра:

antigravity
claude-code
codebuddy
codex
cursor
gemini-cli
github-copilot
glm
hermes
kimi-code
kiro
open-claw
opencode
qwen-code
trae
windsurf
zed

Подробная матрица реестра, целевые пути, состояния возможностей, поддержка MCP и подтверждения закрепления соглашений находятся в техническом справочнике по реестру.

Установка нескольких окруженийCopy Anchor Link

Установите одно окружение или используйте all, чтобы выбрать реестр в детерминированном порядке. Окружения с областью действия проекта требуют --project PATH; это включает all, поскольку реестр содержит как цели с областью действия пользователя, так и цели с областью действия проекта.

apothem install --harness claude-code
apothem install --harness cursor --project /path/to/project
apothem install --harness gemini-cli --project /path/to/project
apothem install --harness all --project /path/to/project

Проверка ваших установокCopy Anchor Link

Проверьте каждый адаптер окружения по отдельности или вызовите apothem doctor для сводки статуса установки по каждому адаптеру среди всех зарегистрированных адаптеров:

apothem verify --harness claude-code
apothem verify --harness all --project /path/to/project
apothem doctor

Как работают адаптерыCopy Anchor Link

Каждый адаптер реализует протокол HarnessAdapter, зарегистрированный через точки входа setuptools. При установке CLI загружает и проверяет общий профиль YAML, разрешает адаптер через реестр, проверяет план материализации и записывает нативную для платформы конфигурацию в нативное пользовательское или проектное расположение окружения. При обновлении он заново выводит из текущего состояния профиля.

profile.yaml + packaged cohorts
    identity / preferences / rules
    commands / skills / delegated definitions / hooks / templates
         |
         +-- antigravity    --> ~/.gemini/GEMINI.md + ~/.gemini/antigravity-cli/plugins/apothem/
         +-- claude-code    --> ~/.claude/ native folders + ~/.claude/.apothem/support/
         +-- codex          --> ~/.codex/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
         +-- cursor         --> <project>/.cursor/rules/*.mdc + <project>/.cursor/agents/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
         +-- gemini-cli     --> <project>/GEMINI.md + <project>/.gemini/
         +-- github-copilot --> <project>/.github/copilot-instructions.md + <project>/.github/agents/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
         +-- windsurf       --> <project>/.devin/rules/ + <project>/.devin/agents/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
         +-- ...

Навыки в вашем домашнем каталоге пользователяCopy Anchor Link

Семь адаптеров с областью действия проекта записывают один файл правил в ваш проект (шесть из них также записывают туда помощников Apothem в виде файлов субагентов; папку называет страница каждого окружения), а также записывают навыки Apothem и правила и шаблоны, на которые ссылаются навыки, в папки в вашем домашнем каталоге пользователя:

cursor, github-copilot, windsurf, zed  ->  ~/.agents/skills/ (codex writes it too)
codebuddy                               ->  ~/.codebuddy/skills/
kiro                                    ->  ~/.kiro/skills/
trae                                    ->  ~/.trae/skills/
all seven                               ->  ~/.config/apothem/rules/ and templates/ (codex uses them too)

• Каждая установка, указывающая папку, записывает одни и те же файлы, поэтому порядок установки не имеет значения, а одна копия обслуживает каждый проект.
• Установка сначала записывает папки в домашнем каталоге. Если это не удаётся, она останавливается до того, как изменить проект, и не добавляет в ваш репозиторий ни одного файла навыка или правила.
• Удаление удаляет общую папку, только когда никакая другая установка Apothem её больше не использует, и сообщает, какая установка её сохраняет.
• Папка навыка с именем навыка Apothem, которую Apothem не записывал, остаётся нетронутой, с предупреждением.

Страница каждого окружения перечисляет его папки. Реестр окружений показывает, какие инструменты разделяют какую папку.

См. Абстракция адаптера окружения для спецификации протокола.