Sobre el proyecto

# opencode-supermemory **Memoria persistente para OpenCode, impulsado por [Supermemory](https://supermemory.ai)** Este plugin otorga a los agentes de OpenCode memoria persistente entre sesiones y proyectos. Inyecta automáticamente contexto relevante, captura turnos de conversación y proporciona herramientas para almacenar y recuperar memorias. ## Instalación ```bash bunx opencode-supermemory@latest install bunx opencode-supermemory@latest login # o establece SUPERMEMORY_API_KEY bunx opencode-supermemory@latest status # verifica la conexión en cualquier momento ``` O pega esto en OpenCode: `Install opencode-supermemory by following https://raw.githubusercontent.com/supermemoryai/opencode-supermemory/main/README.md` Comandos en el chat: `/supermemory-init`, `/supermemory-login`, `/supermemory-logout`, `/supermemory-status`. ## Características - **Inyección de contexto**: En el primer mensaje de una sesión, el agente recibe tu perfil, conocimiento del proyecto y, opcionalmente, una búsqueda semántica sobre memorias personales. - **Recuperación razonada**: En cada turno, el agente decide si recuperar memoria ayudaría antes de responder, buscando a través de la herramienta `supermemory` solo cuando es necesario. - **Captura automática**: Los turnos completados se guardan cada `captureEveryNTurns` turnos, con el resto vaciado al final de la sesión. El contenido `<private>` se redacta. - **Detección de palabras clave**: Decir "recuerda", "guarda esto", "no olvides" (o patrones personalizados) incita al agente a guardar en memoria. - **Indexación del código**: `/supermemory-init` explora y memoriza la estructura del código, patrones y convenciones. - **Compactación preventiva**: Al 80% de capacidad de contexto, activa la resumición, inyecta memorias del proyecto en el resumen y guarda el resumen como memoria. - **Privacidad**: El contenido envuelto en `<private>...</private>` nunca se almacena. - **Avisos de actualización**: Verifica npm para nuevas versiones al inicio de la sesión. ## Uso de la herramienta La herramienta `supermemory` admite modos: `add`, `search`, `profile`, `list`, `forget`, `help`. Ámbitos: `user` (personal) y `project` (predeterminado). Los tipos incluyen `project-config`, `architecture`, `error-solution`, `preference`, `learned-pattern`, `conversation`. ## Alcance de la memoria Las memorias se etiquetan con `repo_{project-name}__{repository-hash}` y metadatos `sm_scope` (personal o proyecto). El hash proviene del remoto de origen Git normalizado, por lo que Claude Code, Codex, Cursor y OpenCode comparten el mismo contenedor para el mismo repositorio. Los contenedores heredados de versiones anteriores siguen siendo legibles. ## Configuración Variables de entorno: `SUPERMEMORY_API_KEY`, `SUPERMEMORY_API_URL`/`SUPERMEMORY_BASE_URL`, `SUPERMEMORY_AUTH_URL`, `SUPERMEMORY_AUTH_TIMEOUT`, `SUPERMEMORY_REPO_TAG`, `SUPERMEMORY_ISOLATE_WORKTREES`, `SUPERMEMORY_DEBUG`. El archivo de configuración `~/.config/opencode/supermemory.jsonc` admite opciones como `similarityThreshold`, `maxMemories`, `injectProfile`, `autoRecallEveryPrompt`, `keywordPatterns`, `compactionThreshold`, `captureEveryNTurns`, `recallMode` (direct/advisory/off) y anulaciones de etiquetas de contenedor. ## Uso con Oh My OpenCode Desactiva su gancho de auto-compactación para evitar conflictos: agrega `{"disabled_hooks": ["anthropic-context-window-limit-recovery"]}` a `~/.config/opencode/oh-my-opencode.json`. ## Desarrollo ```bash bun install bun run build bun run typecheck ``` Registros: `tail -f ~/.opencode-supermemory.log` ## Licencia MIT