second-brain  by NicholasSpisak

LLM-maintained personal knowledge base for Obsidian

Created 1 month ago
338 stars

Top 81.4% 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

1 month ago

Responsiveness

Inactive

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

Explore Similar Projects

Feedback? Help us improve.