convez.ai
MCP ServerProdutividadeIntermediário
Shown06

Vibe Knowledge

Shown06/vibe-knowledge

Transforme sessões de código em flashcards automáticos com spaced repetition

Ver no GitHub
InicialPluginScore · de 0 a 100

Converte 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-knowledge

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 meses
Versão
v1.1.0
Issues abertas
0
Contribuidores
1

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
LayerRoleCost
Capture (capture.py)Logs Edit/Write/Bash events in real-timeZero
Distill (distill-worker.sh)Converts events → cards after each sessionIncluded in Claude subscription
Review (view/index.html)6-tab viewer: Cards / Projects / Glossary / Concept Map / Quiz / RetrospectiveZero
  • 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, .env files 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, *.pem files

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:

ToolWhat it does
vk_search_cardsSearch your flashcards by keyword or project
vk_get_statsTotal cards, terms, projects breakdown
vk_grade_termGrade a term (0=forgot, 1=hazy, 2=got it) — updates SRS schedule

Available resources:

URIContents
vibe://cardsAll your flashcards
vibe://termsFull 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

FileContents
~/.claude/vibe-knowledge/data/cards.jsonlAll flashcards (one JSON per line) — the source of truth
~/.claude/vibe-knowledge/data/terms.jsonGlossary master with SRS state
~/.claude/vibe-knowledge/data/events.jsonlRaw implementation events (grows over time, safe to clear)
~/.claude/vibe-knowledge/data/.cursorCursor: 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.py
  • Stop → distill.sh

A backup was saved at ~/.claude/settings.json.bak-vk-* when you ran install.sh.


License

MIT — see LICENSE

Ver o original no GitHub

Bom para

Relacionados