도구 추가하기

목표: 도구를 하나 더 활성화하여 Apothem이 공유 프로파일로부터 그 도구의 네이티브 구성을 머티리얼라이즈하도록 합니다.

사전 요건

• ~/.config/apothem/profile.yaml에 공유 프로파일(아직 없다면 apothem profile init으로 생성).
• PATH에 등록된 apothem CLI. 자체 포함 소스 트리를 설치했다면 각 커맨드 앞에 PYTHONPATH="$HOME/.apothem/src"를 붙이고 apothem 대신 python -m apothem을 실행하십시오 — 또는 npx @ahmed-g-gad/apothem을 사용하십시오.

단계

1. 등록된 도구 목록을 보고 이미 설치된 것이 무엇인지 확인합니다:

   apothem harnesses list

   apothem harnesses list는 지원되는 모든 id를 출력합니다. 동일한 집합이 도구 목록과 소스 생성 도구 레지스트리에 있습니다. 여기에 목록을 하드코딩하는 대신 사용하는 도구의 id를 선택하십시오 — 어댑터가 추가됨에 따라 목록이 늘어납니다.

2. 대상 도구를 점검하여 범위와 출력 경로를 확인합니다:

   apothem harnesses show cursor

   Scope: project 줄은 어댑터가 프로젝트 트리로 머티리얼라이즈하며 --project PATH가 필요함을 의미합니다. Scope: user는 사용자 범위 구성 디렉터리로 머티리얼라이즈하며 프로젝트 플래그가 필요 없습니다.

3. 파일을 쓰지 않고 설치를 미리 봅니다:

   apothem install --harness cursor --dry-run

4. 도구를 설치합니다. 사용자 범위 도구의 경우:

   apothem install --harness claude-code

   프로젝트 범위 도구의 경우 프로젝트 루트를 전달합니다:

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

   --harness all로 지원되는 모든 도구를 한 번에 설치합니다(프로젝트 범위 도구는 여전히 --project가 필요하며, 프로파일의 exclude_harnesses에 나열된 id는 건너뜁니다).

검증

apothem verify --harness cursor

✓ <harness-id> is verified 줄은 관리되는 대상이 존재하며 파싱됨을 확인합니다. apothem doctor는 모든 도구에 걸친 전체 시스템 뷰를 제공합니다.

관련 항목

• 어댑터가 머티리얼라이즈하는 내용을 변경하려면 프로파일 편집하기 후 apothem update를 다시 실행하십시오.
• 설치하기는 최초 실행 설치를 다룹니다.