mrkeyoor.com_
Tue 27 Oct 03:30 UTC
AI Toolsevaluationupdated 27 Oct 2026

obsidian-second-brain review

Obsidian Second Brain gives AI agents workflows for saving, finding and maintaining linked Markdown notes in an Obsidian vault. The supplied README describes agent commands for capture, retrieval, ingestion and note revision; those descriptions are not evidence that the workflows succeeded in our sandbox.

Verdict

Evaluate Obsidian Second Brain on a copied vault if you want agent-maintained linked notes and will review changes. The measured checkout built successfully but recorded 76 failed tests and 10 collection/setup errors. Keep unattended writes disabled while checking that a representative capture preserves originals and produces claims supported by their sources.

We ran it

Lab card: what happened when we ran obsidian-second-brainScreenshot of obsidian-second-brain (theaioperator.io)
Install✓ · 28s35 packages · 37 MB
Build✓ · 6s
Tests✗ · 381s1025 passed · 76 failed · 2 skipped · 10 errors of 1111 (pytest)
Known vulns0(pip-audit)
Repo393 files~42,445 lines of source · 6.8 MB · 2 CI workflows · tests dir

Answers from our run

Does obsidian-second-brain build from source?

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

Do obsidian-second-brain's tests pass?

No. The project's own test command finished in 381 seconds and reported 1025 passed, 76 failed, 2 skipped, 10 collection errors (pytest).

Does obsidian-second-brain have known vulnerabilities in its dependencies?

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

Who should not use obsidian-second-brain?

Vault owners who require filesystem-enforced protection for original notes: the README describes instruction-based protection.

What are the alternatives to obsidian-second-brain?

Copilot for Obsidian, Basic Memory. Evaluate Obsidian Second Brain on a copied vault if you want agent-maintained linked notes and will review changes.

SetupN/AThe sandbox installed successfully, but the supplied extracts do not establish a complete supported installation procedure or its usability.
DocsN/AThe extracts explain note ownership and background permissions, but omit operational prerequisites needed to assess documentation coverage across installation routes.
CommunityN/ARecent push and issue activity are visible, but maintainer responsiveness and support outcomes were not assessed.
MaturityN/AThe measured test command failed; successful vault editing, retrieval quality and platform compatibility were not established by this run.

Who it’s for

Claude Code users evaluating linked Markdown notes for continuity across sessions.
Researchers prepared to review AI-maintained pages against their original sources.
Engineers willing to evaluate vault writes on a copy before enabling unattended work.

Who it’s NOT for

Vault owners who require filesystem-enforced protection for original notes: the README describes instruction-based protection.
Teams requiring passing validation checks before adoption: our run recorded failed wikilink assertions and JSON-decoding errors.
Users relying on unqualified folder ingestion of DOCX and ODT: issue 370 reports those files excluded in v0.20.0 on Windows.
People whose deciding requirement is an agent interface inside the Obsidian editor; Copilot for Obsidian documents that interface.

Setup reality

Our October 26, 2026 run at commit 0e339f7 installed in 28 seconds, recorded 35 dependencies and 37 MB on disk, and built in 6 seconds. Tests failed with exit 1 after 381 seconds. The recorded summary lists 1,025 passed, 76 failed, 2 skipped and 10 collection/setup errors. The log tail shows wikilink assertions and JSON-decoding failures without establishing their causes. Pip-audit reported 0 known vulnerabilities.

The supplied README describes initialization, capture and retrieval commands. Its research section documents provider credentials and free-source fallbacks for /research and /research-deep. These extracts do not establish the complete plugin installation prerequisites or the requirements of every installation route.

The configured sandbox had 3 CPUs, 8 GB RAM and image ghcr.io/astral-sh/uv:python3.12-bookworm. That image label does not establish actual runtime versions. The README describes background writes as opt-in and says the headless invocation skips permission prompts. Original-note protection relies on instructions. Successful vault editing and platform compatibility were not established.

Original notes have instruction-based protection

Obsidian Second Brain's README says the First-Brain layout protects original notes through instructions, not a filesystem sandbox. That boundary matters when deciding whether to let an agent revise your knowledge base.

The project documents commands for saving conversations, finding notes and revising linked pages. Consider it if you want an agent to maintain Markdown knowledge and can review its changes. The supplied measurements establish installation, build and test outcomes, not reliable note maintenance.

What happened when we ran it

Our sandbox installed Obsidian Second Brain in 28 seconds and built it in 6 seconds. Tests failed with exit 1 after 381 seconds. The October 26, 2026 run used commit 0e339f7 and recorded 35 dependencies occupying 37 MB. The checkout held 393 files, approximately 42,445 source lines and 6.8 MB.

The supplied pytest summary records 1,025 passed, 76 failed, 2 skipped and 10 collection/setup errors, with a recorded total of 1,111. The raw tail also lists one expected failure. These categories should not be combined into a new denominator. Pytest reports 375.86 seconds internally; the outer test step records 381 seconds. They measure different scopes.

The tail shows wikilink-validation assertions expecting markers such as U+2014 and U+00A0 in empty output. Several Windows-compatibility checks fail while decoding JSON, including CRLF and byte-order-mark cases. An environment-file override check also fails. The excerpt identifies failure locations but does not establish their causes. Windows-named checks failing in this sandbox do not prove that Windows deployment fails.

Pip-audit reported 0 known vulnerabilities. The repository scan found 2 CI workflow files and a tests directory, with no Dockerfile. The configured sandbox had 3 CPUs, 8 GB RAM and image ghcr.io/astral-sh/uv:python3.12-bookworm; the image label does not establish actual runtime versions. Retrieval quality, successful vault maintenance and cross-platform behavior remain unassessed.

Review ownership before allowing writes

The README describes human notes in First-Brain/, ingestion captures in raw/ and AI-maintained knowledge in wiki/. Initialization prepares ownership and routing; it does not move or ingest existing notes.

Start with a copied vault containing material you can inspect. Ingest one source, review the resulting notes and compare the files with their earlier state. This is a proposed acceptance procedure, not a workflow completed in our run. Check that the original remains intact and that rewritten claims point to sources that support them. A generated link alone does not establish that support.

The README says the headless background agent uses --dangerously-skip-permissions and ships inert until enabled. It describes a tool set limited to Read, Write, Edit, Glob and Grep, excluding shell commands and network access. These are documented boundaries, not protections independently verified in our run. Leave background work disabled during the first evaluation and review the file changes before considering unattended writes.

Research commands need a separate data-flow decision

The supplied README documents /obsidian-init for setup, /obsidian-save for capture and /obsidian-find for retrieval. The available extracts do not establish complete plugin installation prerequisites, so this review cannot provide a verified installation checklist.

The research section says /research and /research-deep can fall back to free sources when no Perplexity key is configured. Other research commands have their own credential requirements. Check the documented command you intend to use rather than treating all research features as having the same setup.

Local Markdown storage does not establish that every workflow keeps note content local. The README's /notebooklm example uploads selected vault notes to Gemini File Search. Review the command and model route before using private material. The dependency audit and build did not evaluate confidentiality or data flows.

Folder ingestion has a reported document-format gap

Issue 370 reports that folder ingestion excludes DOCX and ODT files although single-source ingestion supports LibreOffice-to-PDF conversion. Opened October 26, 2026, the report names v0.20.0 on Windows. This is a reported limitation, not a result reproduced in our sandbox.

The supplied latest-release endpoint identifies v0.20.0, published October 25, 2026. Repository metadata records a last push on October 26. Those observations are separate from the measured checkout at commit 0e339f7 and do not establish that its failed checks have been resolved.

Choose alternatives by the interface you need

Copilot for Obsidian documents an Agent chat window inside Obsidian. Consider it when an interface inside the editor is the deciding requirement.

Basic Memory documents Markdown knowledge files that humans and AI can read, write and search through MCP. Consider it when connecting an existing MCP client to persistent knowledge files is the main requirement. These are documented differences; this review does not compare the alternatives' reliability or retrieval quality.

The supplied Obsidian Mind overview covers another vault template for persistent agent context. This review's narrower question is whether the measured checks and documented write boundaries justify a trial of Obsidian Second Brain.

Make that trial end with a reviewed file diff and source checks. The supplied run does not establish that the system can maintain your vault reliably.

Alternatives

ProjectWhat it isPick it when
Copilot for ObsidianAn Obsidian plugin that documents an Agent chat interface.Consider it when interacting with an agent inside the Obsidian editor is the deciding requirement.
Basic MemoryMarkdown knowledge files that humans and AI clients can read, write and search through MCP.Consider it when connecting an existing MCP client to persistent knowledge files is your main requirement.

What people are saying

  1. [github-trending] eugeniughelbur/obsidian-second-brain

Sources

  1. Obsidian Second Brain README
  2. Folder ingestion document-format report
  3. Copilot for Obsidian README
  4. Basic Memory README
  5. Obsidian Second Brain repository metadata
  6. Obsidian Second Brain latest release

More ai tools reviews

infinite-canvas · ColossalAI · genoffice · hex · open-duet · drawio-skill · the whole board →