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
Download: v1.1.0v1.1.0 ↓1.1.02026-04-20
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

Latest release

v1.1.0 v1.1.0 2026-04-20
What'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

Snapshot: 2026-11-16T23:08:42Z · Data license Apache-2.0 · JSON