Добавить окружение

Цель: включить ещё одно окружение, чтобы Apothem материализовал нативную конфигурацию этого окружения из вашего общего профиля.

Предварительные требованияCopy Anchor Link

• Общий профиль по адресу ~/.config/apothem/profile.yaml (создайте его с помощью apothem profile init, если он ещё не существует).
• CLI apothem в вашем PATH. Если вы установили самодостаточное дерево исходного кода, добавляйте к каждой команде префикс PYTHONPATH="$HOME/.apothem/src" и запускайте python -m apothem вместо apothem — или используйте npx @ahmed-g-gad/apothem.

ШагиCopy Anchor Link

1. Выведите список зарегистрированных окружений и посмотрите, какие уже установлены:

   Copy Text

   apothem harnesses list

   apothem harnesses list печатает каждый поддерживаемый идентификатор; тот же набор есть в списке окружений и в сгенерированном из исходного кода реестре окружений. Выберите идентификатор для вашего инструмента, а не закрепляйте список здесь жёстко — он растёт по мере добавления адаптеров.

2. Изучите целевое окружение, чтобы подтвердить его область и путь вывода:

   Copy Text

   apothem harnesses show cursor

   Строка Scope: project означает, что адаптер материализуется в дерево проекта и требует --project PATH; Scope: user материализуется в каталог конфигурации пользовательского уровня и не нуждается во флаге проекта.

3. Предпросмотрите установку без записи файлов:

   Copy Text

   apothem install --harness cursor --project /path/to/project --dry-run

4. Установите окружение. Для окружения пользовательского уровня:

   Copy Text

   apothem install --harness claude-code

   Для окружения уровня проекта передайте корень проекта:

   Copy Text

   apothem install --harness cursor --project /path/to/project

   Установите все поддерживаемые окружения сразу с помощью --harness all (окружения уровня проекта по-прежнему нуждаются в --project; идентификаторы, перечисленные в exclude_harnesses в профиле, пропускаются).

ПроверкаCopy Anchor Link

apothem verify --harness cursor --project /path/to/project

Строка ✓ <harness-id> is verified подтверждает, что управляемые цели существуют и разбираются. apothem doctor даёт общесистемный обзор по каждому окружению.

СвязанноеCopy Anchor Link

• Редактируйте профиль, чтобы изменить то, что материализует адаптер, затем повторно запустите apothem update.
• Установка охватывает установку при первом запуске.