obsidian-wiki
Framework for AI agents to build and maintain a digital brain through Obsidian wiki
Obsidian-wiki is an agent skill framework that enables AI assistants to construct and maintain a personal knowledge base using interconnected Obsidian markdown files. It provides 39 slash-command skills that let agents ingest documents, code repositories, chat histories, and screenshots into a structured wiki, then query and maintain that knowledge graph over time. Inspired by Andrej Karpathy's LLM Wiki pattern, it compiles learned information into deduplicated, cross-referenced markdown pages instead of re-processing the same questions repeatedly. The framework works with Claude Code, Cursor, Windsurf, Gemini CLI, and many other AI coding agents without requiring API keys or runtime services.
Key Features
Use Cases
- 01Maintaining a personal knowledge base that grows as you solve problems, preventing re-discovery of solutions buried in old chat logs
- 02Ingesting technical documentation, research papers, and meeting notes into a searchable, cross-referenced wiki
- 03Building a code knowledge graph that connects patterns, architecture decisions, and lessons learned across multiple repositories
- 04Mining agent conversation history to surface topics, connections, and insights from months of coding sessions
- 05Performing structural queries like finding hub pages, detecting broken links, identifying topic clusters, and tracing concept dependencies
- 06Creating a cited briefing on any topic from accumulated knowledge, with wikilink references to source pages
Related Skills
View moresuperpowers
An agentic skills framework & software development methodology that works.
skills
Skills for Real Engineers. Straight from my .agents directory.
skills
Public repository for Agent Skills
ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
obsidian-wiki — FAQ
What is obsidian-wiki?+
Obsidian-wiki is a Python framework that provides 39 agent skills enabling AI coding assistants to build and maintain a personal knowledge base as interconnected Obsidian markdown files. It compiles learned information into a deduplicated, cross-referenced wiki instead of re-asking the same questions or re-running RAG on every query.
How do I install obsidian-wiki?+
Install via pip with 'pip install obsidian-wiki', then run 'obsidian-wiki setup --vault ~/brain' to initialize a vault. Alternatively, use 'uv tool install obsidian-wiki' or 'pipx install obsidian-wiki'. You can also give your agent the GitHub URL and say 'set up my wiki' to complete installation agent-driven.
Which AI agents and clients work with obsidian-wiki?+
The skills work with Claude Code, Cursor, Codex, Windsurf, Gemini CLI, and over a dozen other AI coding agents that can read and execute markdown skill files. A compatibility matrix is provided in the documentation.
Does obsidian-wiki require API keys or a runtime service?+
No. Obsidian-wiki runs entirely locally with no API keys, cloud services, or vendor dependencies. All knowledge is stored as plain markdown files in a folder you control.
Is obsidian-wiki free?+
Yes, obsidian-wiki is open source and released under the MIT license.
How much faster are queries with obsidian-wiki compared to a plain agent?+
Benchmark tests on a 38-page vault showed structural queries (graph connections, hub pages, topic clusters) completed 4.4× faster on average with 83% accuracy versus 44% for a plain agent using only grep and file reading. Wall-clock time dropped from 81 seconds to 19 seconds for the same question set.
How do I install obsidian-wiki?+
Open the source repository on GitHub and follow its README. obsidian-wiki is a skill — MCP Agents Market links you directly to the official repo.
Is obsidian-wiki free?+
obsidian-wiki is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.