Vibe Knowledge
Shown06/vibe-knowledge
Transforme sessões de código em flashcards automáticos com spaced repetition
Ver no GitHubConverte automaticamente suas sessões de codificação com Claude Code em flashcards organizados. Captura eventos de desenvolvimento em tempo real, distila conceitos usando IA, e oferece um visualizador offline com repetição espaçada SM-2 e mapa conceitual. Todos os dados permanecem locais com mascaramento automático de secrets.
Instalação
npx convez-ai Shown06/vibe-knowledge1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Consolidar aprendizado durante desenvolvimento prático
- Revisar conceitos técnicos com quiz baseado em forgetting curve
- Mapear conexões entre termos e decisões arquiteturais
- Manter glossário privado de projetos sem exposição de secrets
Veredito

Solução elegante que aproveita hooks do Claude Code para capturar conhecimento sem overhead. O MCP server adiciona valor permitindo consultas via Claude, e o mascaramento automático de secrets mostra atenção à segurança. Ideal para desenvolvedores que querem consolidar aprendizado contínuo durante desenvolvimento.
README
A tradução para o português deste README ainda está na fila.
Vibe Knowledge
Your vibe-coding sessions, automatically turned into flashcards.
The reverse of vibe-coding.
Every time you build something with Claude Code, Vibe Knowledge silently translates what happened into plain-language flashcards — no extra effort required.
日本語はこちら · vibeknowledge.dev · MCP Server
How it works
You build something with Claude Code
↓ (PostToolUse hook — zero cost, no claude call)
Events captured to events.jsonl
↓ (Stop hook — runs in background via haiku)
"Why did we add a webhook here?" → Plain-language flashcard
↓
Open view/index.html → Review cards, quiz yourself, explore concept map
| Layer | Role | Cost |
|---|---|---|
Capture (capture.py) | Logs Edit/Write/Bash events in real-time | Zero |
Distill (distill-worker.sh) | Converts events → cards after each session | Included in Claude subscription |
Review (view/index.html) | 6-tab viewer: Cards / Projects / Glossary / Concept Map / Quiz / Retrospective | Zero |
- Implementation events with no new concepts → claude is never called (no wasted tokens)
- Distill runs in background — zero latency added to your sessions
- Self-recursion safe: the distill process's own events are ignored
Install
git clone https://github.com/Shown06/vibe-knowledge
cd vibe-knowledge
bash install.sh
That's it. Start building with Claude Code. Cards accumulate automatically.
View your cards:
open view/index.html
Features
- Auto-capture — hooks into Claude Code, nothing to configure per-project
- Secret masking — API keys, tokens,
.envfiles are never stored or sent to the AI - SM-2 spaced repetition — built-in quiz with a forgetting curve
- Concept map — force-directed graph of how terms connect
- Project filtering — cards organized by which project you were building
- Offline viewer — pure vanilla HTML/JS, no server needed
Privacy
All data stays on your machine (~/.claude/vibe-knowledge/data/).
The capture hook automatically redacts:
- API keys and tokens (
sk-...,ghp_...,Bearer ..., etc.) - Password/secret key=value pairs
- Full contents of
.env,*.key,*.pemfiles
MCP Server
Expose your knowledge base to Claude Code as a query-able MCP tool.
cd mcp-server
npm install && npm run build
claude mcp add vibe-knowledge node $(pwd)/dist/index.js
Available tools inside Claude Code:
| Tool | What it does |
|---|---|
vk_search_cards | Search your flashcards by keyword or project |
vk_get_stats | Total cards, terms, projects breakdown |
vk_grade_term | Grade a term (0=forgot, 1=hazy, 2=got it) — updates SRS schedule |
Available resources:
| URI | Contents |
|---|---|
vibe://cards | All your flashcards |
vibe://terms | Full glossary with SRS state |
Card format
{
"term": "Webhook",
"reading": "ウェブフック",
"easy": "A way to automatically notify another system when something happens.",
"why": "Used to notify our server when a Stripe payment completes.",
"analogy": "Like a doorbell — you press it when something happens, whoever's home responds.",
"related": ["API", "Event", "Server"],
"code_ref": "stripe webhook handler"
}
Data files
| File | Contents |
|---|---|
~/.claude/vibe-knowledge/data/cards.jsonl | All flashcards (one JSON per line) — the source of truth |
~/.claude/vibe-knowledge/data/terms.json | Glossary master with SRS state |
~/.claude/vibe-knowledge/data/events.jsonl | Raw implementation events (grows over time, safe to clear) |
~/.claude/vibe-knowledge/data/.cursor | Cursor: last processed events line |
Website
vibeknowledge.dev — project homepage with install instructions and feature overview.
Uninstall
Remove the two hook entries from ~/.claude/settings.json:
PostToolUse→capture.pyStop→distill.sh
A backup was saved at ~/.claude/settings.json.bak-vk-* when you ran install.sh.
License
MIT — see LICENSE