mrkeyoor.com_
Tue 10 Nov 05:39 UTC
LLM Toolsevaluationupdated 31 Oct 2026

claude-obsidian review

Consider claude-obsidian if you want a coding agent to maintain cited notes and you are willing to review vault changes. Trial it on a separate vault first: our run on October 13, 2026, at commit 32ac5a0 did not produce a clean test baseline. claude-obsidian turns source material into linked, source-cited Obsidian pages.

+126stars / 7d
Verdict

claude-obsidian is worth a controlled trial if cited Markdown notes and reviewed writes are central to your workflow. Our run on October 13, 2026, at commit 32ac5a0 left four named wrapper failures, so it does not support an unconditional recommendation. Start with a separate vault, verify extraction and recovery yourself, and keep backups.

We ran it

Lab card: what happened when we ran claude-obsidianScreenshot of claude-obsidian (github.com/AgriciDaniel/claude-obsidian)
Install✓ · 9s35 packages · 38 MB
Build✓ · 6s
Tests✗ · 151s525 passed · 4 failed · 5 skipped of 529 (pytest)
Known vulns0(pip-audit)
Repo205 files~44,316 lines of source · 3.1 MB · 1 CI workflows · tests dir

Answers from our run

Does claude-obsidian build from source?

Dependencies installed in 9 seconds (35 packages), and the build succeeded in 6 seconds. We cloned commit 32ac5a0 into a clean Debian container with 3 CPUs and no project-specific setup.

Do claude-obsidian's tests pass?

No. The project's own test command finished in 151 seconds and reported 525 passed, 4 failed, 5 skipped (pytest).

Does claude-obsidian have known vulnerabilities in its dependencies?

pip-audit found none in the dependency tree at the time of our run.

Who should not use claude-obsidian?

People expecting built-in PDF or EPUB text extraction, OCR, or automatic web fetching.

What are the alternatives to claude-obsidian?

Obsidian Copilot, Smart Connections. claude-obsidian is worth a controlled trial if cited Markdown notes and reviewed writes are central to your workflow.

Setup2/5Material friction on the visible rubric: Python and Bash prerequisites, environment-bound approvals, and four observed wrapper failures despite successful install and build commands.
Docs5/5Unusually complete documented coverage of setup, transaction rules, platform support, recovery and extraction limits. This assesses coverage, not independently verified correctness of every instruction.
Community4/5The supplied primary pages show named contributors, issue reporters and release participation. This assesses visible participation, not adoption, support response time or production usage.
Maturity3/5Useful documented safeguards coexist with four wrapper failures in our dated sandbox run. Interactive agent work, synced-vault recovery and answer quality were not established.

Who it’s for

Claude Code users who want retained sources and linked research notes.
Markdown users willing to inspect mutation plans and maintain backups.
Users of other Agent Skills hosts who can configure the portable skill integration.

Who it’s NOT for

People expecting built-in PDF or EPUB text extraction, OCR, or automatic web fetching.
Native Windows users who cannot use WSL for vault writes.
Readers who require a clean sandbox test result before evaluating a project.
People who need all note processing to remain offline while using Claude Code.

Setup reality

Our sandbox recorded installation of 35 packages in 9 seconds, occupying 38 MB, and a successful build step in 6 seconds. The test command exited 1 after 151 seconds. Its stored parser summaries record 525 passed, 4 failed, a total field of 529, and 5 skipped separately. These are stored parser summaries, not verified exhaustive counts of unique tests.

The portable core requires Python 3.11 or newer; setup scripts require Bash. Obsidian is optional for reading the resulting Markdown. The pinned README recommends a source checkout and a separate vault, followed by reviewing the generated operation and applying its exact approval hash. On Windows, review and apply inside WSL because approval hashes depend on the reviewing environment.

The record does not establish a completed interactive Claude Code session, successful source synthesis, retrieval quality, or recovery on a real synced vault. Successful install and build command outcomes do not establish those workflows.

Start with a separate vault

claude-obsidian turns source material into linked, source-cited Obsidian pages. That makes it worth evaluating for research notes whose summaries need to retain their evidence. The practical commitment is reviewing proposed changes and keeping backups, rather than simply installing an assistant and leaving it unattended.

The README at our measured commit describes immutable source capture, claim and source ledgers, read-only queries, and a transaction core for writes. Helpers return drafts; one orchestrator combines the operation. Target hashes detect changes made after planning, and a journal supports rollback after an interrupted write. These are documented controls, not a guarantee against data loss. The current README also explains that the lock coordinates cooperating local writers, not other devices or external editors.

What our run actually established

Our run took place on October 13, 2026, at commit 32ac5a0. The exact stored commit is 32ac5a02c4e082e4a5628ca810776375e134708e. Our sandbox used Python 3.12 with 3 CPUs and 8 GB RAM.

The test command in our sandbox exited 1 after 151 seconds. Installation and build returned zero, with stored durations of 9 and 6 seconds respectively. The installed dependency footprint was 35 packages and 38 MB.

The attached stored parser summaries record 525 passed, 4 failed, a total field of 529, and 5 skipped separately. They do not establish exhaustive unique test coverage; we have not reconciled a complete log or performed a new execution. Skipped tests are not failures.

The raw footer names four failures in tests/test_setup_wrappers.py: test_dragonscale_check_reports_actual_extension_state, test_dragonscale_default_is_a_read_only_plan, test_mode_apply_forwards_exact_review_approval, and test_mode_uses_cwd_vault_without_empty_array_failure. Each reports VAULT_SENTINEL_MISSING for /work/repo and an unexpected exit code. The tail establishes the observed wrapper failures, but does not isolate their cause. It does not show the concurrent transaction failure described in the previous page text.

Our harness stores each command's outcome, exit code, elapsed time and output tail alongside parsed counts. The testing methodology explains that reporting model and its limits. That page is provenance context, not evidence that its current procedure was used unchanged for this older run.

The audit record contains zero recorded pip-audit advisories. Scan coverage is unknown: no scannedPackages field establishes which packages were checked, and the stored packages value is zero. This is not a security assessment.

We did not establish interactive agent behavior, answer accuracy, successful ingestion of a research collection, native Windows operation, or synced-vault recovery. The recorded build success is a command outcome, not proof of deployment or a completed user workflow.

Check extraction and privacy before choosing it

The pinned README says PDF and EPUB capture retains metadata, hash and size without built-in semantic extraction. URL and YouTube operations need a configured external runner, and OCR needs an external tool. Local BM25 retrieval is available; remote models and contextual processing require explicit egress consent.

Those boundaries matter before you collect a large inbox. Verify the extraction path for your actual source formats before expecting linked notes from them.

Local files also do not mean wholly local AI processing. The current README explicitly says that notes read through Claude Code are sent to Claude. Additional web research and remote models require permission, but your selected agent still determines where its input is processed.

Native Windows supports inspection and previews; vault writes require WSL. Keep review and apply in that environment. For synced vaults, test on a copy and retain independent backups because external editors and other devices do not share the local writer lock.

Choose an interface or discovery tool for a different need

Obsidian Copilot brings OpenCode, Claude Code, and Codex into Obsidian. Consider it when working inside the Obsidian interface is your main requirement. Its README describes an agent that can inspect notes, use tools and create files with permissions you control. That establishes an interface alternative; it does not establish equivalent provenance or transaction behavior.

Smart Connections uses local embeddings to surface semantically related notes. Consider it when rediscovering existing notes is the task. It can complement a source-capture workflow, rather than replace its ingestion and transaction machinery. Its current README says Smart Chat is a separate plugin, so bundled chat should not drive this choice.

How to read the ratings

These are editorial ratings, not benchmark results. The scale is 1 for substantial documented obstacles, 2 for material setup friction, 3 for useful capability with unresolved limits, 4 for strong supporting evidence, and 5 for unusually complete evidence within the dimension being assessed. Setup considers prerequisites and observed command outcomes; documentation considers coverage of operation and limits; community considers visible project participation rather than adoption; maturity considers operational evidence and unresolved failures.

Setup ease remains 2/5 because the small install still requires environment-aware approvals and the wrapper tests failed. Documentation remains 5/5 for its explicit installation, transaction, platform, recovery and capability guidance; that rating does not certify every link or instruction. Community remains 4/5 based on visible contributions and issue participation in the supplied primary pages, not inferred production usage. Maturity remains 3/5 because the documented safeguards coexist with an unsuccessful sandbox test command and untested interactive workflows.

Before adopting an existing vault, create a separate trial vault, inspect the first operation, check that the agent can read its required contracts, and exercise the source formats and recovery path you intend to use.

Alternatives

ProjectWhat it isPick it when
Obsidian CopilotAn Obsidian plugin that brings OpenCode, Claude Code, and Codex into the app.Choose it when an agent interface inside Obsidian is the priority. The supplied evidence does not establish equivalence with claude-obsidian's provenance and transaction controls.
Smart ConnectionsAn Obsidian plugin that uses local embeddings to find related notes.Choose it for semantic discovery in an existing vault. Treat it as a possible complement to source ingestion; Smart Chat is a separate plugin.

What people are saying

  1. [github-trending] AgriciDaniel/claude-obsidian

Sources

  1. claude-obsidian README
  2. claude-obsidian repository metadata
  3. claude-obsidian v2.1.1 release
  4. Windows hook timeout report
  5. iCloud recovery report
  6. Broken skill reference links

More llm tools reviews

memorilla · 12-factor-agents · gemini-api-cli · MCPJungle · octomind · kimi-k3-in-c · the whole board →