OpenCode

Proveedor: OpenCode Nombre de instalación: opencode Estado: Beta Configuración nativa: ~/.config/opencode/

InstalaciónCopy Anchor Link

apothem install --harness opencode

El adaptador escribe la configuración JSON de OpenCode, instala las skills de Apothem en la superficie de skills de OpenCode, convierte los prompts de comando en archivos de comando Markdown de OpenCode y normaliza las definiciones de ayudantes de Apothem como subayudantes de OpenCode.

Archivos escritos:

~/.config/opencode/opencode.json
~/.config/opencode/apothem/rules/00-apothem-profile.md
~/.config/opencode/commands/
~/.config/opencode/skills/
~/.config/opencode/agents/
~/.config/opencode/.apothem/support/{rules,templates,hooks}/

Asignación del perfil a la configuración nativaCopy Anchor Link

El adaptador renderiza opencode.json con una lista de archivos instructions que nombra tu documento de perfil, las cuatro reglas principales y el índice de reglas, y luego propaga cada cohorte compartida de Apothem a una superficie nativa de OpenCode o a un subárbol de soporte propiedad de Apothem. Los hijos existentes gestionados por Apothem que coinciden se respaldan antes de reemplazarse.

Notas de compatibilidadCopy Anchor Link

OpenCode combina en cada sesión todos los archivos que nombra la lista instructions (reglas de OpenCode). Por eso la lista nombra primero tu documento de perfil y después solo las reglas cuyo alwaysApply es true, cada una con una ruta ~/.config/opencode/.apothem/support/rules/<name>.md explícita; OpenCode expande el ~/ inicial contra tu directorio personal. Esas reglas son agnostic-posture, authority-inquiry, context-management, session-closure y el índice de reglas, apothem-rule-index. OpenCode no limita ninguna regla por ruta, así que cualquier otra regla se lee bajo demanda. Queda instalada como material de referencia bajo ~/.config/opencode/.apothem/support/, y el índice nombra cada regla y la situación que la requiere. Una regla, una skill o un comando que cite una regla, una plantilla o un prompt de hook lo lee desde allí. Los comandos, las skills y las definiciones de ayudantes usan ubicaciones de descubrimiento nativas.

El documento de perfil ~/.config/opencode/apothem/rules/00-apothem-profile.md lleva tu identidad y tus preferencias del perfil compartido, y termina con una sección de archivos de soporte de Apothem que nombra el directorio absoluto bajo ~/.config/opencode/.apothem/support/ contra el que se resuelve cada cita con estilo de repositorio (rules/<name>.md, templates/..., hooks/...). Es la primera entrada de instructions, así que OpenCode lo carga en cada sesión.

Un opencode.json escrito por un lanzamiento anterior lista el único glob ~/.config/opencode/.apothem/support/rules/*.md, que carga todas las reglas, o una ruta explícita para cada una de las 28 reglas que entonces estaban siempre activas. apothem install y apothem update reemplazan cualquiera de las dos formas por la lista anterior, lo que descarta las 24 rutas que ya no se cargan al iniciar, y apothem uninstall las elimina todas. Tus propias entradas de instructions se conservan en todos los casos.

VerificaciónCopy Anchor Link

apothem verify --harness opencode

El comando verify confirma que:

1. La configuración nativa existe en la ruta esperada.
2. Cada destino gestionado existe; los archivos gestionados no están vacíos y las configuraciones JSON o YAML se analizan correctamente. Añade --profile PATH para confirmar también que los archivos instalados coinciden con ese perfil.
3. La rutina de verificación específica del adaptador informa de éxito.

ActualizaciónCopy Anchor Link

apothem update --harness opencode

Refresca opencode.json, los comandos nativos, las skills, las definiciones de ayudantes y el árbol de soporte de Apothem.

DesinstalaciónCopy Anchor Link

apothem uninstall --harness opencode

Elimina las entradas que el adaptador agregó a ~/.config/opencode/opencode.json (tus propias claves, servidores MCP y entradas de instructions permanecen, y el archivo se elimina solo cuando Apothem lo creó y no queda nada tuyo). Elimina el bloque de Apothem del documento de perfil ~/.config/opencode/apothem/rules/00-apothem-profile.md y conserva cualquier otro texto que contenga; ese archivo se elimina solo cuando no queda nada más en él. También elimina los archivos de Apothem en ~/.config/opencode/commands/, ~/.config/opencode/skills/, ~/.config/opencode/agents/ y ~/.config/opencode/.apothem/support/; los demás archivos de esas carpetas permanecen. Cada archivo se respalda bajo ~/.apothem/backups/ antes de modificarse o eliminarse. El YAML del perfil compartido y el motor de Apothem no se ven afectados.

Puerta de conformidadCopy Anchor Link

python -m apothem.conformity.gate --all .

Solución de problemasCopy Anchor Link

Opciones de configuraciónCopy Anchor Link

Véase tambiénCopy Anchor Link

• Todos los entornos — el catálogo completo de herramientas compatibles
• Guía de instalación — instala Apothem en este entorno
• Referencia de apothem harnesses — lista e inspecciona adaptadores desde la CLI