A local-first Obsidian knowledge system plugin integrating Claude Code. It ingests sources, builds linked Markdown vaults, and supports a recoverable transaction workflow. Latest release includes native Windows compatibility and read-only support.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
claude-obsidian is a local-first knowledge system for Claude Code and compatible Agent Skills hosts. It turns source material into linked, source-cited Obsidian pages; answers from the evidence already in the vault; and provides explicit workflows for research, retrieval, maintenance, and visual mapping.
Your vault remains a normal directory of Markdown, JSON, and source files. It is not hidden in a plugin cache, locked in a cloud database, or silently uploaded to a model.
How it works
The project organizes a repeatable loop: retain the source, ground the claims, connect the knowledge, then put it back to work. It captures sources with context, grounds important claims with provenance, and builds linked pages, indexes, and maps of content. It supports queries against the existing vault evidence and maintains a provenance-aware model. It operates with local filesystem sources, optional BM25 retrieval, and various workflow skills (e.g., wiki, wiki-ingest, wiki-query).
Key capabilities include: local ownership of vault files, source-cited notes, and explicit workflows for research, retrieval, maintenance, and visualization within Obsidian.
Getting started
Quick start steps shown in the README:
- Get the product:
git clone https://github.com/AgriciDaniel/claude-obsidian.git
cd claude-obsidian
- Initialize a separate vault:
export GENERATED_AT="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
export OPERATION_ID="init-reviewed"
python3 scripts/claude-obsidian.py init "$HOME/Documents/MyKnowledgeVault" \
--generated-at "$GENERATED_AT" --operation-id "$OPERATION_ID"
Copy the approved plan SHA256 and apply:
python3 scripts/claude-obsidian.py init "$HOME/Documents/MyKnowledgeVault" \
--generated-at "$GENERATED_AT" --operation-id "$OPERATION_ID" \
--approved-plan-sha256 "<sha256-from-the-plan>" --apply
- For existing vaults, adopt non-destructively per installation guide.
- Start from the vault:
cd "$HOME/Documents/MyKnowledgeVault"
claude --plugin-dir /absolute/path/to/claude-obsidian
Then use the provided invocations, e.g. "/claude-obsidian:wiki" and related commands.
15 skills, one system
The project exposes skills such as wiki, save, wiki-ingest, wiki-query, wiki-lint, autoresearch, canvas, defuddle, wiki-fold, wiki-mode, wiki-retrieve, wiki-cli, obsidian-markdown, obsidian-bases, think. Claude Code exposes namespaced invocations like "/claude-obsidian:wiki-lint"; other hosts use their native Agent Skills invocations.
Release notes (latest releases)
Latest releases include v2.1.0 Native Windows Compatibility with read-only operations, v2.0.0 focusing on reliability and evidence refoundation, and earlier updates adding features like DragonScale memory layer and cross-link with claude-canvas. The README lists the latest five releases with dates and brief notes.
Traction
Stars: 10371; Forks: 1201; Open issues: 126
Behind the repo
claude-obsidian is described as a local-first knowledge system for Claude Code and compatible Agent Skills hosts, with a focus on owning the vault and linking notes for a knowledge graph.
Caveats
Requires Python 3.11 or newer, Obsidian, and Bash; Git for development. Windows/Wsl notes indicate read-only inspection and dry-run commands on native Windows; vault writes require WSL and error on unsupported platforms. The project uses a transaction-based approach with explicit operation IDs and approved plan hashes for mutations. The license is MIT.