second-brain  by NicholasSpisak

LLM-maintained personal knowledge base for Obsidian

Created 3 months ago
598 stars

Top 53.8% on SourcePulse

GitHubView on GitHub
Project Summary

Summary This project offers an LLM-maintained personal knowledge base for Obsidian, automating the structuring of raw documents into a navigable wiki. It targets users seeking AI-driven knowledge organization, providing an intelligently curated and interconnected information repository for browsing and querying.

How It Works Users deposit raw documents into a raw/ folder. An integrated AI agent processes these inputs, generating structured wiki pages, cross-references, and an index. The knowledge base is then browsed within Obsidian, enabling exploration via links, graph views, and natural language queries to the LLM librarian.

Quick Start & Requirements Install via npx skills add NicholasSpisak/second-brain. Initiate setup with /second-brain in your AI agent (guided wizard). Prerequisites include Obsidian for browsing, Node.js for installation, and an AI coding agent supporting Agent Skills (e.g., Claude Code, Codex, Cursor, Gemini CLI). An Obsidian Web Clipper is recommended for ingestion.

Highlighted Details

  • Vault structure includes raw/ for input, wiki/ for LLM content (summaries, entities, concepts, index), and output/.
  • Core AI skills provided: /second-brain (setup), /second-brain-ingest (process), /second-brain-query (ask), and /second-brain-lint (health-check).
  • Optional qmd tool significantly speeds up wiki queries for large knowledge bases.
  • Supports multiple AI agents working on the same vault.
  • Image attachments are managed via Obsidian settings and the raw/assets/ directory.

Maintenance & Community Users are encouraged to join the "Build With AI community." Specific maintainer, sponsorship, or roadmap details are not provided in the README.

Licensing & Compatibility The README omits explicit license information, requiring further investigation for commercial use. Compatibility is focused on Obsidian and AI agents supporting the Agent Skills standard.

Limitations & Caveats Requires a compatible AI coding agent. Query performance may degrade without optional tools like qmd. Re-running setup is idempotent; a fresh start needs manual vault deletion. The /second-brain-lint skill is essential for maintaining index consistency and fixing broken wikilinks.

Health Check
Last Commit

3 months ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
1
Star History
213 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.