Adaptadores de entorno

Apothem incluye diecisiete adaptadores de entorno integrados. Cada adaptador traduce los mismos conjuntos compartidos en archivos nativos de la plataforma donde la plataforma los admite y en árboles de soporte propios de Apothem donde no.

Entornos compatiblesCopy Anchor Link

El registro de entornos compatibles contiene exactamente diecisiete adaptadores. Usa estos nombres exactos de instalación con --harness, o usa all para el conjunto determinista del registro:

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

La matriz detallada del registro, las rutas de destino, los estados de capacidad, la compatibilidad con MCP y la evidencia de anclaje de convenciones viven en la referencia técnica del registro.

Instala varios entornosCopy Anchor Link

Instala un entorno, o usa all para seleccionar el registro en orden determinista. Los entornos de ámbito de proyecto requieren --project PATH; eso incluye all porque el registro contiene destinos tanto de ámbito de usuario como de ámbito de proyecto.

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

Verifica tus instalacionesCopy Anchor Link

Verifica cada adaptador de entorno por separado, o ejecuta apothem doctor para obtener un resumen del estado de instalación por adaptador de todos los adaptadores registrados:

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

Cómo funcionan los adaptadoresCopy Anchor Link

Cada adaptador implementa el protocolo HarnessAdapter registrado mediante los entry-points de setuptools. Durante la instalación, la CLI carga y valida el perfil YAML compartido, resuelve el adaptador a través del registro, valida el plan de materialización y escribe la configuración nativa de la plataforma en la ubicación nativa de usuario o de proyecto del entorno. Durante la actualización, vuelve a derivar a partir del estado actual del perfil.

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}/
         +-- ...

Skills en tu directorio personalCopy Anchor Link

Siete adaptadores con alcance de proyecto escriben un archivo de reglas en tu proyecto (seis de ellos también escriben allí los ayudantes de Apothem como archivos de subagentes; cada página de entorno nombra la carpeta), y también escriben las skills de Apothem, y las reglas y plantillas que citan las skills, en carpetas de tu directorio personal:

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)

• Cada instalación que nombra una carpeta escribe los mismos archivos, así que el orden en que instalas no importa, y una sola copia sirve a todos los proyectos.
• Una instalación escribe primero las carpetas del directorio personal. Si eso falla, se detiene antes de cambiar el proyecto, y no añade ningún archivo de skill ni de regla a tu repositorio.
• Una desinstalación elimina una carpeta compartida solo cuando ninguna otra instalación de Apothem la sigue usando, e indica qué instalación la conserva.
• Una carpeta de skill con el nombre de una skill de Apothem que Apothem no escribió se deja intacta, con una advertencia.

Cada página de entorno lista sus carpetas. El registro de entornos muestra qué herramientas comparten qué carpeta.

Consulta Abstracción del adaptador de entorno para ver la especificación del protocolo.