jessepinkman9900 /claude-second-brain
Fastest way to scaffold your LLM powered personal knowledge base - Obsidian, Claude Code, qmd, Github
★ 166⑂ 23👁 0⑃ 21● 3▤ 13
166
stars
23
forks
0
watchers
21
prs
3
issues
13
releases
README
:classical_building: claude-second-brain Your notes don't compound. This wiki does. The fastest way to start your personal knowledge base powered by Obsidian, Claude Code, qmd, and GitHub. npx claude-second-brain One command gives you a fully wired knowledge system: - Claude ingests your sources and maintains a cross-linked wiki - qmd powers local semantic search - The scaffolded folder is your Obsidian vault — open it directly in Obsidian, with obsidian-git pre-configured for seamless sync - GitHub is the source of truth — version history, anywhere access, and a backup you control You've been reading papers, articles, and books for years. Drop a source in, run /brain-ingest, and Claude reads it — extracts what matters, cross-links it to everything you already know, and files it. Ask a question six months later and get cited answers, not a list of files to re-read. Inspired by Andrej Karpathy's approach to LLM-powered knowledge management — share an "idea file" with an LLM agent and let it build and maintain your knowledge base. !Obsidian graph view of a running wiki --- How this is different This is not a RAG system. It's not a chatbot over your notes. It's an actively maintained, cross-linked wiki — five structured page types, YAML frontmatter, and a set of Claude Code skills that run the whole thing. The schema (CLAUDE.md) is that idea file. Claude reads it every session. --- The stack | Tool | Role | |---|---| | Claude Code | Reads sources, writes wiki pages, cross-links, flags contradictions | | qmd | Local hybrid search (vector + BM25) across your entire wiki | | Obsidian | Graph view, backlinks, mobile reading — offline, no extra sync | | GitHub | Source of truth — version history, Claude Code anywhere, Obsidian sync | Everything is pre-configured. You bring the sources. --- Get started in 3 steps Step 1 — Scaffold bash npx claude-second-brain Or install globally — csb is a shorter alias: bash npm i -g claude-second-brain csb The CLI will ask: - Brain name — what to call this brain (default: my-brain) - GitHub repo — optionally create a private repo and push automatically (requires gh CLI) Creates the brain at ~/.claude-second-brain/my-brain/, registers it in ~/.claude-second-brain/config.toml, installs mise + node + pnpm, runs pnpm install, and git init. Step 2 — Generate vector embeddings bash cd ~/.claude-second-brain/my-brain pnpm qmd:reindex First run downloads ~2GB of GGUF models — once per machine. qmd collections are already registered by the CLI during scaffolding. Step 3 — Open in Obsidian (and push to GitHub if not done) If you created a GitHub repo during setup, it's already pushed — skip straight to opening in Obsidian. If you skipped GitHub during setup, connect it now: bash git remote add origin https://github.com/you/my-brain.git git push -u origin main Open ~/.claude-second-brain/my-brain/ as a vault in Obsidian — the folder is already a valid Obsidian vault. The Git plugin
Top issues
#14feat: s3 backend w dvc for sizes larger than GitHub limit of 5gb0 comments · 2026-04-14#13docs: setting up iCloud sync0 comments · 2026-04-14#12feature: hermes wiki agent w telegram + parallel/exa web research0 comments · 2026-04-14
Latest release
v1.1.0 v1.1.0 2026-04-20What's Changed feat(cli): add use/exec/doctor, positional path, per-subcommand help by @jessepinkman9900 in https://github.com/jessepinkman9900/claude-second-brain/pull/21 Full Changelog: https://github.com/jessepinkman9900/claude-second-brain/compare/v1.0.0...v1.1.0