Hypomnema - wiki personal nativo de LLM que funciona dentro de Claude Code (código abierto)

Hypomnema es un wiki personal OSS nativo de LLM que funciona dentro de Claude Code con un solo slash.
Vive en la carpeta ~/hypomnema/ con Markdown en texto plano + git, y no requiere servicios externos / claves de API / base de datos vectorial.
Lo original que aporta el usuario se conserva tal cual en sources/, y los resultados sintetizados por Claude se van acumulando en pages/.
Cuando vuelve a encontrarse con el mismo tema, no crea una página nueva sino que actualiza la existente.

La razón para crearlo fueron cuatro problemas acumulados al trabajar con IA todos los días.
(1) El costo de volver a explicar el contexto de ayer en cada sesión nueva
(2) Los resultados se acumulan rápido, pero como no queda registro de por qué se implementó así, depurar un mes después sale más caro como deuda técnica
(3) Probé Notion, Obsidian y Confluence, pero los wikis manuales terminan cayendo en cuatro trampas: "sin automatización / sin síntesis / se vuelven legado / no se consultan"
(4) Un gist breve de Karpathy — "RAG relee todo cada vez, pero un wiki conserva el conocimiento ya sintetizado una vez. El cuello de botella siempre fue el bookkeeping, y los LLM reducen ese costo a 0" — mostró la respuesta.

Así que empecé con dos carpetas de Markdown y fui agregando hooks del ciclo de vida cada vez que aparecía una molestia cotidiana.

Resumen clave

• Concepto: wiki en lugar de RAG (Retrieval-Augmented Generation, generación aumentada por recuperación). El LLM conserva las páginas sintetizadas una vez y la próxima vez sigue construyendo sobre ellas. Markdown en texto plano + git, sin servicios externos / claves de API / base de datos vectorial.
• Instalación: npm install -g hypomnema → /hypo:init en Claude Code.
• Fuente única + reflejo unidireccional: las correcciones de comportamiento se registran solo en pages/feedback/<slug>.md. El comando hypomnema feedback-sync recalcula y refleja automáticamente eso en MEMORY.md (límite de 200 líneas) y <learned_behaviors> (límite de 10 elementos, validación estricta de 5 campos).
• Nuevos campos obligatorios de SCHEMA: fuerza 9 campos requeridos en páginas type: feedback. upgrade --apply genera automáticamente una checklist de backfill. Los borradores automáticos (stub) se rechazaron a propósito: si se fijan valores por defecto erróneos, ese comportamiento incorrecto fluye silenciosamente hacia dos superficies derivadas (MEMORY y CLAUDE.md).
• Sincronización empaquetada de archivos de extensión: dentro del wiki se incluyen los directorios extensions/{agents,commands,hooks,skills} y se reflejan automáticamente en ~/.claude/. Si se usa el flag --codex, en ~/.codex/ solo se refleja el subconjunto hooks + commands (incluyendo los hooks esenciales).
• Más automatización: si no hay un proyecto wiki en el directorio de trabajo actual (cwd), sugiere crearlo automáticamente; al terminar una sesión con contenido significativo, sugiere automáticamente un cierre ligero (minimal crystallize); después de WebFetch / WebSearch, muestra una sugerencia para /hypo:ingest; notificaciones de actualización por 2 canales (npm / plugin); advertencia de lint W8 para detectar design-history.md obsoletos; bloqueo de correcciones que se escapan a otros proyectos (se fuerza coincidencia exacta de scope: project:*); primera etapa de limpieza de comentarios de código (elimina referencias atadas al momento cuyo significado se diluye con el tiempo, pero conserva los anchors de diseño).

Diferencias frente a otros OSS de wiki para LLM

En poco tiempo aparecieron más de 10 proyectos derivados del gist de Karpathy.
Tras revisarlos directamente, estas son las diferencias por área:

• Área principal de Hypomnema: automatización del ciclo de vida de la sesión (14 hooks que vinculan la operación del wiki a SessionStart / PreCompact / Stop, etc.), unificación de fuente única para corregir el comportamiento de la IA + reflejo automático unidireccional, y mirroring automático a ~/.claude/{commands,agents,skills,hooks}.
• nvk/llm-wiki: destaca por su modo de verificación que ejecuta en paralelo agentes a favor y en contra de una tesis con --mode thesis.
• SamurAIGPT/llm-wiki-agent: destaca por el ingest multiformato de PDF / Word / PPT / Excel.
• nashsu/llm_wiki: su GUI de escritorio en Electron (6.6k stars) es la más madura.

Hypomnema no implementó deliberadamente modo thesis, ingest multiformato ni GUI propia: esos proyectos lo hacen mejor en esas áreas, y si hace falta se pueden usar junto con herramientas existentes como Obsidian.
En resumen, el punto más fuerte de Hypomnema es llevar el wiki al flujo de trabajo diario que usan los usuarios de Claude Code.

Componentes

8 comandos slash (/hypo:ingest, /hypo:query, /hypo:crystallize, /hypo:resume, /hypo:feedback, /hypo:verify, /hypo:lint, /hypo:graph) + 5 subcomandos de CLI (init, upgrade [--apply] [--codex], doctor [extensions], uninstall, feedback-sync) + 14 hooks del ciclo de vida + compatibilidad con Claude Agent Skills.
El comportamiento detallado de cada comando y hook está documentado en el README y en el walkthrough en inglés de dev.to.

Lo que se omitió a propósito

Sin base de datos vectorial, claves de API, GUI, matriz de modos ni stubs automáticos de SCHEMA: todo eso se excluyó deliberadamente por dos motivos: "los valores por defecto erróneos terminan convirtiéndose silenciosamente en comportamientos erróneos" o "otra herramienta ya lo hace bien".

Requisitos + enlaces

• Node.js ≥ 18 / Claude Code CLI
• GitHub: https://github.com/sk-lim19f/Hypomnema · npm: https://www.npmjs.com/package/hypomnema · Licencia: MIT
• Retrospectiva: https://velog.io/@dlatkdrb980219/…

Guía para contribuir

Se agradecen comentarios, issues y PRs.