How jessepinkman9900/claude-second-brain works
claude-second-brain is a CLI scaffold generator for an Obsidian- and Claude Code-based personal knowledge wiki. The user creates a brain, adds source material, runs ingestion to synthesize linked wiki pages, and later searches the indexed wiki for cited answers. Refresh, rebuild, lint, and Git-backed access are additional product capabilities. The workflow is documented in the README; sampled code shows CLI and qmd setup/reindex behavior, but not the skill implementations, so those relationships rely on README evidence.
Main entry points: reindex.ts Local QMD Index · wiki Cross-linked Wiki · SKILL.md Search Skill · create.js Scaffold CLI
Components 16
Brain Setup
- Scaffold CLI
bin/create.js - Brain Vault
template
Knowledge Workflow
- Raw Sources
template/raw-sources - Ingest Skill
template/.claude/skills/brain-ingest/SKILL.md - Cross-linked Wiki
template/wiki - Search Skill
template/.claude/skills/brain-search/SKILL.md - Wiki Lint
template/.claude/skills/lint/SKILL.md
Search Index
- Index Refresh
template/.claude/skills/brain-refresh/SKILL.md - Index Rebuild
template/.claude/skills/brain-rebuild/SKILL.md - Collection Setup
template/scripts/qmd/setup.ts - Index Reindex
template/scripts/qmd/reindex.ts - Local QMD Index
template/scripts/qmd/reindex.ts
Vault Access
- Obsidian Vault
template/.obsidian - GitHub Remote
- Claude Code
Other components
- User
Connections 23
- User → Scaffold CLI: creates brain
README.md - Scaffold CLI → Brain Vault: scaffolds files
bin/create.js - Scaffold CLI → Collection Setup: registers collections
README.md - User → Raw Sources: adds material
README.md - Ingest Skill → Raw Sources: reads sources
README.md - Ingest Skill → Cross-linked Wiki: writes synthesis
README.md - User → Search Skill: asks question
README.md - Search Skill → Local QMD Index: hybrid searches
README.md - Local QMD Index → Search Skill: returns pages
README.md - Search Skill → User: answers with citations
README.md - User → Wiki Lint: checks wiki
README.md - User → Index Refresh: refreshes index
README.md - Index Refresh → Local QMD Index: updates embeddings
README.md - User → Index Rebuild: redesigns index
README.md - Index Rebuild → Collection Setup: patches schema
README.md - Collection Setup → Local QMD Index: configures collections
template/scripts/qmd/setup.ts - Index Reindex → Local QMD Index: updates and embeds
template/scripts/qmd/reindex.ts - Cross-linked Wiki → Local QMD Index: indexed for search
README.md - Raw Sources → Local QMD Index: registered collection
- Cross-linked Wiki → Obsidian Vault: opened as vault
README.md - Cross-linked Wiki → GitHub Remote: syncs through Git
README.md - GitHub Remote → Claude Code: enables remote work
README.md - GitHub Remote → Obsidian Vault: syncs vault
README.md