5.6 KB · updated 2026-07-31 · md

claude-code-plugin.es.md

docs/i18n/integrations/claude-code-plugin.es.md

Plugin de Claude Code

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Русский · Français · Deutsch

<!-- translations:end -->

Tesserae incluye un plugin de Claude Code para que puedas ejecutar el flujo de trabajo completo de Tesserae desde dentro de una sesión TUI — comandos slash, un servidor MCP autoregistrado, una habilidad que orienta al agente y cuatro hooks que cierran el bucle agente↔memoria-de-proyecto. El plugin vive en el repositorio en plugin/.

Instalación

# Requisito previo: `tesserae` ya instalado (`pip install tesserae` o `pipx install tesserae`).
/plugin install /path/to/Tesserae/

Requisito previo: tesserae ya instalado (pip install tesserae o pipx install tesserae). Si instalas con pipx, asegúrate de que ~/.local/bin esté en el PATH que Claude Code hereda al lanzarse.

Qué incluye

  • 9 comandos slash — siete envoltorios 1:1 alrededor de la CLI (/tesserae:compile, /tesserae:ask, /tesserae:sessions-import, /tesserae:build-site, /tesserae:serve, /tesserae:obsidian-sync, /tesserae:setup) más dos macros de flujo de trabajo (/tesserae:refresh encadena import + compile + obsidian-sync; /tesserae:status muestra conteos del grafo y última compilación).
  • Registro automático del servidor tesserae — el agente obtiene toda la superficie de herramientas como mcp__plugin_tesserae_tesserae__<tool> sin ediciones manuales de configuración: consultas de grafo (search_nodes, node_context, graph_ppr, search_facts), el compilador bajo demanda compile_context / list_communities / fresh_insights, memoria de sesiones (ask, list_sessions, find_session_findings, find_code_symbol_mentions) y configuración guiada (tesserae_setup_plan / tesserae_setup_apply). La lista completa está en mcp.es.md.
  • Habilidad using-tesserae — se carga automáticamente cuando preguntas sobre el grafo tipado, recuperación de sesiones pasadas, contenido wiki/vault, o cualquier flujo de trabajo tesserae. Enseña al agente qué herramienta MCP usar vs qué comando slash sugerir.
  • 5 hooks — SessionStart imprime un resumen del grafo; SessionEnd ejecuta en segundo plano import+compile para que las ideas de esta conversación se conviertan en nodos del grafo para la próxima sesión; dos hooks PostToolUse se disparan en Edit/Write/MultiEdit — uno hace recompilación incremental opcional en ediciones de docs/, el otro aplica un debounce (~30 s) a la sincronización del grafo de código; PreToolUse (en Bash) controla compilaciones de grafos grandes mediante un diálogo de confirmación.

La compilación al cerrar la sesión es oportunista, no garantizada. El hook desacopla su tarea en segundo plano con setsid cuando existe, y recurre a nohup en caso contrario. macOS no incluye setsid, y nohup solo ignora SIGHUP — deja la tarea en el grupo de procesos de la sesión —, así que un harness que recoja el grupo al cerrar la sesión todavía puede matar la compilación a mitad. Lo que queda entonces es recuperable, no intacto: graph.json se escribe con un rename atómico, así que nunca queda a medias, pero las proyecciones generadas wiki/ y site/ se borran al inicio de la escritura de artefactos y el almacén SQLite se escribe después de graph.json, de modo que una muerte en esa ventana las deja ausentes o una compilación por detrás. Eso sí, nunca ocurre en silencio: .tesserae/manifest.json marca un documento como graphed solo cuando los artefactos aterrizan, así que la siguiente compile --changed-only rechaza su no-op, avisa graph.json is not known to cover every tracked document y vuelve a extraer todo el corpus, lo que también reconstruye las proyecciones. No construyas un flujo que asuma que una compilación larga sobrevive a la sesión que la lanzó: ejecútala en primer plano o mediante tesserae engine.

Detalles completos, tablas completas de comandos/hooks e instrucciones de opt-out por proyecto están en el propio MD0 del plugin.

¿Por qué un plugin Y un servidor MCP?

Roles diferentes:

  • Herramientas MCP = consultas de grafo de solo lectura que el agente invoca durante una conversación. Siempre activas, baja fricción.
  • Comandos slash = acciones de flujo de trabajo que invocas explícitamente (compile, refresh, obsidian-sync). Alto apalancamiento pero debe ser tu decisión.

Puedes usar solo el servidor MCP (edición manual de claude_desktop_config.json vía tesserae projects mcp-config). El plugin simplemente lo empaqueta junto con los comandos slash, la habilidad y los hooks, haciendo que la instalación sea un solo paso.

Verificar instalación

/plugin list
/mcp
/tesserae:status

Desinstalar

/plugin uninstall tesserae

Reversible. No toca el directorio .tesserae/ de ningún proyecto.

Véase también