Hypomnema - wiki pessoal nativo para LLM que funciona dentro do Claude Code (código aberto)

Hypomnema é um OSS de wiki pessoal LLM-native que funciona dentro do Claude Code com uma única barra.
Ele vive na pasta ~/hypomnema/ com Markdown em texto puro + git, sem serviço externo / chave de API / banco vetorial.
Os materiais originais enviados pelo usuário são preservados como estão em sources/, e os resultados sintetizados pelo Claude se acumulam em pages/.
Quando encontra o mesmo tema de novo, ele não cria uma nova página; atualiza a existente.

A razão para criá-lo foram quatro problemas acumulados ao trabalhar com IA todos os dias.
(1) o custo de ter que explicar de novo o contexto de ontem a cada nova sessão
(2) os resultados se acumulam rapidamente, mas o porquê de ter sido feito assim não fica em lugar nenhum, criando dívida técnica que torna o debug mais caro um mês depois
(3) já usei Notion, Obsidian e Confluence, mas wikis manuais desmoronam nas quatro armadilhas de "sem automação / sem síntese / viram legado / ninguém olha"
(4) um pequeno Gist do Karpathy — "RAG relê tudo todas as vezes, mas uma wiki torna permanente o conhecimento sintetizado uma vez. O gargalo sempre foi bookkeeping, e LLM reduz esse custo a 0" — apontou a resposta.

Então comecei com duas pastas de Markdown e fui adicionando um hook de ciclo de vida cada vez que aparecia alguma irritação no uso diário.

Resumo principal

• Conceito: wiki em vez de RAG (Retrieval-Augmented Generation). A página sintetizada uma vez pelo LLM é preservada, e na próxima vez ele continua construindo em cima dela. Markdown em texto puro + git, sem serviço externo / chave de API / banco vetorial.
• Instalação: npm install -g hypomnema → /hypo:init no Claude Code.
• Fonte única de verdade + refletência unidirecional: correções de comportamento são registradas em um único lugar, pages/feedback/<slug>.md. O comando hypomnema feedback-sync recalcula e reflete automaticamente em MEMORY.md (limite de 200 linhas) e <learned_behaviors> (limite de 10 itens, com validação rígida de 5 campos).
• Novos campos obrigatórios no SCHEMA: páginas type: feedback exigem 9 campos obrigatórios. upgrade --apply gera automaticamente um checklist de backfill. Rascunhos automáticos (stub) foram rejeitados de propósito — se valores padrão errados forem fixados ali, comportamentos incorretos escorrem silenciosamente para as duas superfícies derivadas (MEMORY e CLAUDE.md).
• Sincronização com arquivos de extensão incluídos: os diretórios extensions/{agents,commands,hooks,skills} ficam junto da wiki e são espelhados automaticamente para ~/.claude/. Com a flag --codex, apenas o subconjunto hooks + commands (incluindo hooks principais) é espelhado para ~/.codex/.
• Automação reforçada: se não houver um projeto wiki no diretório de trabalho atual (cwd), ele sugere criá-lo automaticamente; ao fim de uma sessão significativa, sugere automaticamente um fechamento leve (minimal crystallize); logo após WebFetch / WebSearch, mostra uma sugestão para /hypo:ingest; notificações de atualização em 2 canais (npm / plugin); aviso de lint W8 para encontrar design-history.md antigo; bloqueio de correções vazando para outros projetos (correspondência exata obrigatória em scope: project:*); fase 1 de limpeza de comentários de código (remoção de referências presas ao momento que perdem significado com o tempo, preservando âncoras de design).

Diferenças em relação a outros OSS de LLM Wiki

Mais de 10 projetos derivados do Gist do Karpathy surgiram em pouco tempo.
Organizando as diferenças por área após analisá-los diretamente:

• Área principal do Hypomnema: automação do ciclo de vida da sessão (14 hooks conectando a operação da wiki a SessionStart / PreCompact / Stop etc.), fonte única para correção de comportamento da IA + refletência automática unidirecional, espelhamento automático de ~/.claude/{commands,agents,skills,hooks}.
• nvk/llm-wiki: forte no modo de verificação com --mode thesis, executando em paralelo agentes pró e contra uma proposição.
• SamurAIGPT/llm-wiki-agent: forte em ingest multiformato de PDF / Word / PPT / Excel.
• nashsu/llm_wiki: a GUI desktop em Electron (6.6k stars) é a mais madura.

O Hypomnema deliberadamente não criou modo thesis, ingest multiformato nem GUI própria — esses projetos fazem isso melhor, e, se necessário, ferramentas existentes como Obsidian podem ser usadas junto.
Resumindo, a área em que o Hypomnema é mais forte é trazer a wiki para dentro do fluxo de trabalho diário de quem usa Claude Code.

Componentes

8 comandos de barra (/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 de ciclo de vida + compatibilidade com Claude Agent Skills.
O funcionamento detalhado de cada comando e hook está organizado no README e no walkthrough em inglês no dev.to.

O que foi deixado de fora de propósito

Sem banco vetorial, chave de API, GUI, matriz de modos ou stub automático de SCHEMA — tudo isso foi excluído deliberadamente por duas razões: "valores padrão errados escorrem silenciosamente para comportamentos errados" ou "outras ferramentas já fazem isso bem".

Requisitos + links

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

Contribuições

Feedback, issues e PRs são bem-vindos.