uninstall

하니스 어댑터 구성을 제거합니다.

개요Copy Anchor Link

apothem uninstall --harness NAME|all [--yes] [--project PATH]
                   [--quiet|-q] [--verbose|-v]
                   [--format plain|json] [--json] [--no-color]

어댑터가 관리하는 하니스 대상을 제거한 다음, 설치가 만든 디렉터리가 비어 있으면 그 디렉터리를 제거합니다(여러분의 것이 하나라도 들어 있는 디렉터리는 남습니다).

그 디렉터리에 설치된 하니스가 이 하니스 하나뿐일 때에만 공유 작업 디렉터리의 메모리, 컨텍스트, 학습 저장소가 백업된 뒤 제거됩니다. 제거는 설치가 기록해 둔 위치에서 이루어지므로, 설치가 이들을 어디에 썼든 제거가 그 위치를 찾습니다(workspace 프로필 필드를 참조하세요). plans/ 디렉터리는 절대 제거되지 않습니다.

--yes를 지정하지 않으면 확인을 요청합니다. 프롬프트를 띄울 수 없는 경우 — --format json(프롬프트 텍스트가 단일 JSON 문서를 손상시킴) 또는 비대화형 셸(TTY 없음) — 명령은 --yes를 지정하지 않으면 처음부터 구조화된 uninstall.confirmation_required 오류(종료 코드 1)와 함께 거부합니다. 선택한 하니스가 설치되어 있지 않으면 명령은 성공(종료 코드 0)하며, 일반 출력에서는 NAME is not installed; nothing to remove.를 출력합니다. 여기서 NAME은 하니스 식별자입니다.

설치 루트의 .apothem/ 아래에 있는 공유 데이터 저장소(memory/, contexts/, learning/)는 같은 루트의 다른 설치된 하니스가 여전히 사용하는 동안 그대로 남습니다. 제거하는 하니스가 해당 루트의 마지막 하니스이면, 명령은 먼저 각 저장소를 Apothem 백업 루트(~/.apothem/backups/)로 복사한 다음, 그 안의 모든 것과 함께 저장소를 제거합니다. plans/에 보관한 것은 절대 제거되지 않습니다.

홈 디렉터리의 공유 폴더Copy Anchor Link

여러 설치가 홈 디렉터리의 한 폴더를 사용할 수 있습니다. 스킬 폴더 (~/.agents/skills/, 또는 ~/.codebuddy/skills/, ~/.kiro/skills/, 또는 ~/.trae/skills/)와 ~/.config/apothem/rules/ 및 ~/.config/apothem/templates/입니다. install 페이지는 어떤 어댑터가 어느 폴더에 쓰는지 나열합니다. Apothem은 각 폴더를 어떤 설치가 사용하는지 기록하며, 제거는 한 가지 규칙을 따릅니다. 다른 Apothem 설치가 더 이상 그 폴더를 사용하지 않을 때에만 폴더를 제거합니다.

• 한 도구를 제거해도 다른 설치가 아직 스킬을 사용하는 동안에는 스킬이 유지되며, 명령이 그렇다고 알려 줍니다. 두 프로젝트에 설치된 한 도구는 두 개의 설치로 계산되므로, 프로젝트 A에서 그 도구를 제거해도 프로젝트 B가 아직 사용하는 동안에는 폴더가 유지됩니다. 마지막 제거가 폴더를 제거합니다(아래 두 번째 예제 참조).
• 설치 자체의 기록에 나열된 것만 제거됩니다. 폴더가 관리되기 전에 이루어진 설치에는 그런 기록이 없으므로, 그 설치를 제거해도 홈에서는 아무것도 제거되지 않습니다. 여러분이 폴더에 추가한 파일은 남으며, Apothem 스킬의 이름을 가졌지만 Apothem이 쓰지 않은 폴더도 남습니다.
• 프로젝트 폴더가 더 이상 존재하지 않는 설치는 무시되므로, 삭제된 프로젝트가 폴더를 영원히 붙잡아 두지 않습니다. 참고가 그 설치의 이름을 알려 줍니다.
• 폴더를 사용할 수 있는 설치의 기록을 읽을 수 없으면, 제거는 아무것도 제거하기 전에 오류와 함께 중단되며, 그 설치는 기록된 상태로 남습니다. 읽을 수 없는 기록을 복구하거나 옮긴 다음 명령을 다시 실행하세요. 이 폴더들에 전혀 쓰지 않는 도구의 손상된 기록은 무시됩니다.
• 마지막 사용이 사라지면 비게 된 폴더도 제거됩니다. 각 폴더는 제거되기 전에 ~/.apothem/backups/ 아래에 백업됩니다.

각 제거는 폴더마다 하나의 Note:를 출력합니다. 예를 들어 Note: <harness> - ~/.agents/skills/ was kept: still used by <harness> (/path/to/project), 또는 was removed: no other Apothem install uses it입니다. --format json 봉투에서 각 참고는 "outcome": "advisory", "operation": "shared_root", 그리고 retained 또는 released로 설정된 "role"이 담긴 warnings 항목입니다. 이 항목은 path, holders(폴더를 유지시키는 설치), stale(무시된 설치), 그리고 kept와 total(유지된 기록 항목과 설치가 나열한 항목)을 담습니다.

찾을 수 없는 설치 때문에 폴더가 남아 있다면, 참고가 그 설치의 이름을 알려 줍니다. 프로젝트 폴더가 삭제된 경우, 그 설치는 무시되고 폴더는 다음 제거 때 함께 사라집니다. 프로젝트는 존재하지만 그 규칙 파일에서 Apothem 블록을 직접 제거한 경우, uninstall은 그 하니스를 설치되지 않은 것으로 보고하며 그 점유를 해제하지 않습니다. 해제하려면 해당 하니스와 프로젝트에 대해 install을 실행한 다음 uninstall을 실행하세요. apothem verify는 폴더가 아직 온전한지 보여 줍니다.

--harness all 제거는 의도적으로 빠짐없이 수행됩니다. 이 제거는 등록된 모든 하니스를 대상으로 하며, 여기에는 설치 중 프로필의 exclude_harnesses가 건너뛰는 하니스도 포함됩니다. 정리 작업은 이전에 더 넓은 범위로 설치했을 때 남았을 수 있는 상태까지 닿습니다. 한 번도 설치되지 않은 하니스에도 같은 알림이 표시됩니다.

연속형 별칭 apothem uninstalling(apothem Uninstalling으로도 받아들여짐)은 같은 핸들러로 해석됩니다.

옵션Copy Anchor Link

JSON 출력Copy Anchor Link

어댑터가 설치되어 있었고 성공적으로 제거된 경우:

{
  "schema_version": 1,
  "status": "success",
  "command": "uninstall",
  "action": "uninstalled",
  "harness": "claude-code",
  "profile_path": null,
  "project": null,
  "files_written": [],
  "results": [
    {
      "harness": "claude-code",
      "outcome": "updated",
      "operation": "uninstall",
      "path": "C:\\Users\\Example\\.claude\\settings.json",
      "message": "managed files removed"
    }
  ],
  "warnings": [],
  "error": null,
  "output_path": "C:\\Users\\Example\\.claude\\settings.json"
}

어댑터가 설치되어 있지 않았던 경우 명령은 0으로 종료합니다. JSON 출력에서 봉투는 "status": "success"와 "action": "uninstalled"를 가지며, results 행은 "outcome": "skipped"와 메시지 "not installed; no files removed"를 가집니다. status 필드는 결코 "not_installed"가 아닙니다.

예제Copy Anchor Link

apothem uninstall --harness claude-code
apothem uninstall --harness claude-code --yes
apothem uninstall --harness cursor --project . --yes
apothem uninstall --harness all --project . --yes
apothem uninstalling --harness cursor --project . --yes   # continuous-form alias

공유 스킬 폴더는 그 폴더를 사용하는 마지막 설치가 사라질 때까지 남습니다.

apothem install --harness codex
apothem install --harness cursor --project A
apothem uninstall --harness codex --yes                  # keeps ~/.agents/skills/, the cursor install uses it
apothem uninstall --harness cursor --project A --yes     # removes it: no install uses it now

종료 코드Copy Anchor Link

함께 보기Copy Anchor Link

• apothem uninstalling — 이 명령의 연속형 별칭(여기에 문서화됨. CLI는 두 형식을 모두 받음)
• apothem install — 하니스 구성을 설치합니다
• apothem verify — 설치 상태를 확인합니다