Communitygithub.com

VRIL-LABS/portable-agent-memory

🧠 Un sistema de memoria avanzado y portátil para agentes, optimizado para su uso en cualquier agente, permitiendo a los desarrolladores mejorar la calidad de su código. Puede usarse como sistema de memoria complementario o independiente.

¿Qué es portable-agent-memory?

Este skill proporciona una capa de persistencia de memoria local para proyectos, almacenada en `<project_root>/memories/` y gestionada mediante `scripts/memory <cmd>`. Está diseñado para ser complementario a cualquier otro mecanismo de memoria existente en el host, actuando como una capa adicional basada en archivos. La salida de los comandos es JSON, por lo que se recomienda ejecutar `read` para confirmar el estado en disco. Desde la versión 1.1.0, también crea una base de datos SQLite + FTS5 oculta (`.memsys-db`) para indexación y búsqueda, manteniendo los archivos Markdown como la fuente de verdad. El skill incluye una serie de documentos de referencia que detallan el flujo de trabajo completo (ingesta, recuperación, razonamiento, reflexión, ejecución y empaquetado), la estructura de almacenamiento, cuándo guardar información, reglas estrictas (como no exceder 200 líneas o no escribir fuera de `memories/`), el contrato de la base de datos y ejemplos prácticos. Antes del primer uso, se debe ejecutar `scripts/memory selftest` para verificar la instalación.

Compatible con✓Claude Code~Codex CLI✓Cursor✓Gemini CLI✓Windsurf
npx skills add VRIL-LABS/portable-agent-memory

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Sistema de Memoria

Capa de persistencia para memoria local del proyecto, en <project_root>/memories/, mediante scripts/memory <cmd> (respaldado por references/memory_tool, la fuente de verdad determinista para esta capa — nunca modifiques su salida ni lo reimplementes). No asume que el host no tenga otro mecanismo de memoria; si existe uno, trata este como una capa adicional basada en archivos junto a él. La salida estándar es JSON; vuelve a ejecutar read para confirmar el estado en disco.

Desde la versión 1.1.0, init también crea un <project_root>/.memsys-db oculto (SQLite + FTS5, journal_mode=DELETE, un solo archivo, sin -wal/-shm) — el plano de índice y búsqueda regenerable. Markdown sigue siendo la fuente de verdad.

Comienza aquí, en orden:

  1. references/protocol.md — el flujo de trabajo completo de ingesta → recuperación → razonamiento → reflexión → ejecución → empaquetado, más comandos e invocaciones de inicio rápido.
  2. references/layout.md — diseño del almacenamiento y qué cargar para una consulta determinada.
  3. references/when-to-save.md — clasificar: habilidad vs. índice vs. tema vs. rechazar, y enrutamiento de habilidades vs. memoria.
  4. references/constitution.md — reglas estrictas (nunca omitir escaneo de secretos, nunca exceder 200 líneas, nunca escribir fuera de memories/, nunca enumerar mediante bash, nunca usar WAL en el libro de contabilidad).
  5. references/memsys-db.md — el contrato del libro de contabilidad .memsys-db: esquema, search/reindex/forget, y por qué la base de datos nunca supera a Markdown.
  6. references/examples.md — ejemplos prácticos: camino feliz, rechazo de secretos, recuperación de sobrescritura.

Verifica la instalación con scripts/memory selftest antes del primer uso.

Skills relacionados