Desinstalación

Elimina primero las configuraciones de entornoCopy Anchor Link

El comando apothem a secas que se usa en esta página es el shim que escribe el instalador de un solo paso (canal 3 de la guía de instalación); funciona cuando el directorio de ese shim está en PATH. En los demás canales de instalación, sustituye apothem por npx @ahmed-g-gad/apothem, tal como describe la guía de instalación.

Antes de desinstalar Apothem, elimina la configuración de cada adaptador de entorno para dejar tus entornos en un estado limpio. Ejecuta apothem harnesses list para ver qué adaptadores están instalados actualmente y, después, elimínalos de uno en uno o usa el selector de todo el registro:

apothem uninstall --harness claude-code
apothem uninstall --harness cursor --project /path/to/project
apothem uninstall --harness all --project /path/to/project --yes

Pasa --yes para omitir la solicitud de confirmación por entorno.

Elimina el motorCopy Anchor Link

La eliminación depende del canal de instalación que usaste. Los números de canal son los de la tabla de canales de instalación:

• Plugin de Claude Code (canal 1) — elimina el plugin desde dentro de Claude Code: /plugin uninstall apothem@apothem (la entrada del marketplace se puede eliminar con /plugin marketplace remove ahmed-g-gad/apothem).

• npx (canal 2) — no hay nada que eliminar; npx se ejecuta desde su caché. Vacíala con npm cache clean --force si quieres que desaparezca la copia en caché.

• Instalador de un solo paso (canal 3) — ejecuta el script de desinstalación correspondiente desde el checkout: scripts/installer/uninstall.sh (POSIX) o scripts/installer/uninstall.ps1 (PowerShell). Cada script elimina el entorno indicado con --harness (-Harness en PowerShell); si no se indica, usa APOTHEM_HARNESS; si tampoco está definido, usa Claude Code. También elimina el shim del comando apothem. El código fuente se toma de APOTHEM_SOURCE cuando está definido, o de APOTHEM_HOME (valor predeterminado $HOME/.apothem). El código fuente se conserva salvo que pases --remove-source (-RemoveSource en PowerShell). Esa marca elimina solo el clon gestionado en APOTHEM_HOME, y únicamente cuando tiene un directorio .git. Con la ubicación predeterminada, también elimina las copias de seguridad de la instalación y el registro bajo ~/.apothem/. Ambos piden confirmación antes de eliminar las configuraciones de entorno y el código fuente. --yes (-Yes en PowerShell) omite las confirmaciones. Ambos rechazan destinos inseguros.

• Extensión de la familia VS Code (canal 4) — ejecuta primero Apothem: Uninstall desde la paleta de comandos para eliminar las configuraciones de entorno y, después, elimina la extensión desde la vista de Extensiones o con code --uninstall-extension ahmed-g-gad.apothem-vscode (una copia instalada desde un apothem.vsix anterior es ahmed-g-gad.apothem). De forma predeterminada, la extensión ejecuta el motor mediante npx, así que la entrada npx de arriba cubre la caché.

• Arranques de línea de comandos (canales 5–7) — elimina la extensión o el plugin con su herramienta anfitriona una vez que las configuraciones de entorno ya no existan. Los hosts:

  Copy Text

  channel 5   Gemini CLI extension
  channel 6   Qwen Code extension
  channel 7   Codex plugin

  El arranque solo añade contexto de asistente (un archivo de contexto, un comando o una skill) que llama al motor mediante npx, así que no queda nada más. Los hosts de extensión de los canales 5 y 6 admiten un comando de desinstalación; para el host de plugin del canal 7, desinstala apothem en su explorador de plugins.

  Copy Text

  gemini extensions uninstall apothem   # channel 5
  qwen extensions uninstall apothem     # channel 6

• Motor directo (canal 8) — no hay nada que desinstalar; elimina el clon una vez que las configuraciones de entorno ya no estén.

• Copias de seguridad y estado — las copias de seguridad de instalación residen bajo ~/.apothem/backups/ y el historial de instalaciones bajo ~/.apothem/state/. Ambos tienen un tamaño acotado: después de cada instalación, desinstalación y reversión, Apothem conserva los 10 registros de instalación más recientes por raíz de instalación y los 10 conjuntos de copias de seguridad más recientes por entorno, y nunca elimina una copia de seguridad que un registro conservado todavía necesite, de modo que las 10 últimas instalaciones aún se pueden revertir. Para conservar menos, ejecuta apothem backups prune --keep N (añade --dry-run para ver primero qué eliminaría); nunca elimina la copia de seguridad desde la que restaura la reversión de la instalación más reciente de un entorno. Una vez eliminado el motor, y cuando ya no necesites nada del historial, elimina ~/.apothem/.

Lo que NO se eliminaCopy Anchor Link

• apothem uninstall nunca elimina el YAML del perfil compartido en ~/.config/apothem/profile.yaml o --profile PATH.
• Los archivos no relacionados escritos por el operador en los directorios de los entornos se conservan.
• Las entradas que añadiste a un archivo de ajustes compartido se conservan: tus propias reglas de permisos, servidores MCP y manejadores de hooks permanecen. La desinstalación elimina solo las claves y las entradas de lista que el historial de instalaciones registra como de Apothem (consulta Configuración).
• Los almacenes de datos compartidos bajo .apothem/ en la raíz de instalación (memory/, contexts/, learning/) permanecen mientras otro entorno instalado en la misma raíz los siga usando. Al desinstalar el último entorno de esa raíz, cada almacén se copia primero en ~/.apothem/backups/ y después se elimina con todo su contenido.
• Las suites de plan bajo <project>/.apothem/plans/ (y el heredado <project>/.plans/) no se ven afectadas.

DirectoriosCopy Anchor Link

La desinstalación también elimina los directorios que creó la instalación (por ejemplo, un ~/.claude/ que no existía antes de la primera instalación), una vez que están vacíos. Un directorio que todavía contiene un archivo tuyo, o datos que usa otro entorno instalado, permanece. Los directorios que existían antes de la instalación nunca se eliminan.

Para limpiar por completo la raíz de un entorno, elimina la ruta nativa del entorno documentada en las páginas de referencia de entornos después de confirmar que has hecho una copia de seguridad de cualquier regla, trabajador delegado o archivo de perfil personalizado que quieras conservar.