mrkeyoor.com_
Tue 01 Sept 17:43 UTC
AI Toolsevaluationupdated 01 Sept 2026

claudian review

Claudian puts coding agents such as Claude Code, Codex, Grok, OpenCode, and Pi inside an Obsidian sidebar. It lets an agent read and edit vault files, search notes, run shell commands, use MCP tools, and carry out multi-step work without moving the conversation to a terminal.

trackingstars / 7d
Verdict

Installing Claudian on our box took 33 seconds but added 862 packages and 906 MB; the build passed in 34 seconds, while tests timed out at 900 seconds. Use it if Obsidian is already your working desk and you understand that the chosen agent can edit files and run commands there. Wait if mobile support, strict subfolder isolation, hook-based policy enforcement, or stable collaboration is a requirement rather than a preference.

We ran it

Lab card: what happened when we ran claudianScreenshot of claudian (github.com/YishenTu/claudian)
Install✓ · 33s862 packages · 906 MB
Build✓ · 34s
Tests✗ timed out · 900sran, no count parsed
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo1588 files~442,832 lines of source · 19.3 MB · 8 CI workflows · tests dir

Answers from our run

Does claudian build from source?

Dependencies installed in 33 seconds (862 packages), and the build succeeded in 34 seconds. We cloned commit 191e7c5 into a clean Debian container with 3 CPUs and no project-specific setup.

Do claudian's tests pass?

We could not finish them: the suite was still running after 15 minutes in our container.

Does claudian have known vulnerabilities in its dependencies?

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

Who should not use claudian?

Mobile Obsidian users: the README and plugin manifest both mark Claudian as desktop-only.

What are the alternatives to claudian?

Obsidian Copilot, Smart Connections, Khoj. Installing Claudian on our box took 33 seconds but added 862 packages and 906 MB; the build passed in 34 seconds, while tests timed out at 900 seconds.

Setup3/5Easy plugin install, but provider CLI paths and accounts add work
Docs4/5Clear requirements, privacy notes, architecture, and troubleshooting
Community5/515,096 stars, a current release, and daily issue and PR activity
Maturity3/5Build passed, tests timed out, and collaboration remains experimental

Who it’s for

Obsidian desktop users who already use a supported coding-agent CLI and want it beside their notes.
Writers and researchers who need agent-driven file edits with an inline word-level diff before accepting changes.
Developers who want Claude Code or Codex sessions, skills, slash commands, and MCP tools available inside a vault.
Small teams willing to test an experimental Git-backed LAN collaboration mode.

Who it’s NOT for

Mobile Obsidian users: the README and plugin manifest both mark Claudian as desktop-only.
Vault owners who cannot let an agent treat the vault root as its working directory: file reads, writes, search, and bash are central features, while open issue 1118 asks for per-conversation subfolder scope.
Teams that depend on Claude Code SessionStart or PreToolUse hooks as an enforcement boundary: open issue 1137 reports those hooks did not run in plugin sessions even though the same configuration worked in the terminal CLI.
Windows users who require every user-scope MCP server to behave exactly like direct Claude Code: issue 1147 reports a configured stdio server that never spawned inside Claudian 2.2.4.
Groups that need settled shared-editing behavior today: the README labels Collab Mode experimental and requires Git.

Setup reality

Our sandbox installed 862 packages in 33 seconds and used 906 MB on disk. The build succeeded in 34 seconds. Tests timed out at 900 seconds; the visible tail kept reporting PASS results, but the command never completed. Npm audit found 0 known vulnerabilities.

The Community Plugins route is easier than the source build, but Claudian still needs Obsidian 1.13.0 or newer, one supported agent CLI, and a compatible subscription or API provider. Provider prompts, attached files, images, and tool outputs go to the selected provider.

Source development declares Node 24, while the repository uses Bun for lockfile work and npm scripts for common commands. GUI PATH differences can hide a CLI that works in a terminal, Windows wrappers have special rules, and Collab Mode adds Git plus LAN coordination.

A 442,832-line plugin is closer to an IDE than a chat panel

Claudian embeds Claude Code, Codex, Grok Build, OpenCode, and Pi inside Obsidian. The 442,832-line source reflects a wide job: sidebar chat, inline editing, file search, shell commands, skills, MCP connections, session history, and provider-specific transports. A selected note or @-mentioned file becomes agent context, while the vault is the working directory. The result feels more like putting an agent-enabled terminal beside your notes than adding a question box to a writing app.

The checkout had 1,588 files and occupied 19.3 MB before installation. Users can keep several chat tabs, resume sessions, preview word-level inline edits, and switch into Plan Mode before implementation. The provider-neutral core is backed by separate adapters for Claude, Codex, Grok, OpenCode, and Pi, which explains both the reach and the maintenance burden. Each CLI has its own history, model selection, tool events, approvals, and process behavior that the plugin must translate into one Obsidian interface.

Obsidian 1.13.0 and one agent CLI are mandatory

The plugin requires Obsidian 1.13.0 or newer and runs only on macOS, Linux, and Windows desktops. At least one supported agent harness must be installed, plus a subscription or API provider that the harness can use. Claudian does not supply model access. The privacy section says prompts, attached files, images, and tool outputs are sent to the selected provider, so the account and retention policy behind that CLI still govern the conversation.

Community Plugins is the sensible installation path for most people. Source development is heavier: our run added 862 packages and 906 MB, while package.json declares Node 24. The README uses npm install and npm run build, and the repository also carries a Bun lockfile. A CLI visible in a terminal may be absent from Obsidian's GUI environment. The troubleshooting guide therefore covers explicit executable paths, custom PATH variables, and Windows native binaries instead of .cmd or .ps1 wrappers.

What happened when we ran it

Our sandbox installed Claudian in 33 seconds, resolving 862 packages and consuming 906 MB on disk. The production build succeeded in 34 seconds. We used commit 191e7c5 in a fresh unprivileged Debian container with 3 CPUs and 8 GB of RAM. Npm audit reported 0 known vulnerabilities: 0 critical, 0 high, 0 moderate, and 0 low. The build result shows that this large TypeScript plugin can be assembled cleanly in the stated environment.

The test command did not finish before the 900-second cap. Its last visible lines continued to report PASS for unit and integration files, including LocalProjectCleanupCoordinator.test.ts and ProviderRegistry.test.ts; the log tail showed no failing assertion. That still counts as a timeout, because we never received a complete suite summary. The repository had 8 CI workflow files, no Dockerfile, and a tests directory. These measurements do not cover provider logins, an Obsidian launch, or live agent tool calls.

Whole-vault scope makes permissions a daily decision

Claudian's headline capability is also its largest risk: an agent can read, write, search, and run bash with the vault as its workspace. Plan Mode lets a user inspect a proposed approach, and inline edits show word-level changes, but many tasks go beyond one note. A 906 MB development install is merely local overhead; an incorrect shell command or path can alter the material a user cares about. Keep vault history or backups and review the provider's approval settings before routine use.

Open issue 1118 asks for a vault subfolder to become the working directory per conversation because the current default is the vault root. Issue 1137 is more serious for policy-minded users: its reporter says Claude Code SessionStart and PreToolUse hooks did not execute inside Claudian, and a write that the hook should block succeeded. The report covers one setup. Teams using hooks as a write barrier should reproduce the control before trusting it.

Version 2.2.5 is active, with provider-specific gaps still open

Release 2.2.5 arrived on August 30, 2026, and includes fixes for CodeQL findings, Windows Pi session persistence, OpenCode retries, keyboard access, and collaboration state. Fast releases are useful for a plugin following several external CLIs, though they also mean a report tied to 2.2.3 may no longer describe the newest package. Check the affected provider and version before applying an old workaround. The latest release also calls Collab Mode experimental in the README rather than presenting it as settled.

Some open reports remain directly relevant. Issue 1147 describes a Windows user-scope MCP server that worked from Claude Code in a terminal but never spawned inside Claudian 2.2.4. Issue 1230 reports escaped ampersands from linked paths being reused as literal filenames, creating duplicate folder trees. The repository's 8 CI workflows and extensive test tree show serious verification effort, yet our 900-second timeout means we cannot add a clean full-suite result to those signals.

Experimental collaboration moves Git data across the LAN

Collab Mode lets invited users work on shared projects, with Git data and authenticated coordination metadata moving directly between devices on the local network. The README says project data does not go to a Claudian cloud service through this mode. Git is required, and the feature is explicitly experimental in version 2.2.5. Host authority, transfers, conflict review, cleanup, and recovery all appear in the source tree, which is far more machinery than ordinary shared note editing. Test it with disposable vault copies first.

GitHub showed 15,096 stars and 72 combined open issues and pull requests on September 1, 2026. The open list contained 33 issues and 39 pull requests, while the repository was pushed that same day, two days after release 2.2.5. Maintenance is active, though provider gaps remain. Claudian is a direct way to put a coding agent inside Obsidian when desktop-only access and whole-vault authority fit. The 900-second timeout keeps maturity at 3.

Alternatives

ProjectWhat it isPick it when
Obsidian CopilotAn Obsidian assistant centered on chat, vault search, and note-aware model use.pick this instead when asking questions over notes matters more than exposing a coding-agent CLI and shell tools.
Smart ConnectionsAn Obsidian plugin for local semantic search and related-note discovery.pick this instead when you mainly want related notes and excerpts without an agent editing the vault.
KhojA self-hostable personal assistant that can answer from documents and run scheduled agent work.pick this instead when you need a broader assistant across documents and devices rather than an Obsidian-only coding-agent panel.

What people are saying

  1. [github-trending] YishenTu/claudian

Sources

  1. Claudian README
  2. Claudian package manifest at commit 191e7c5
  3. Claudian 2.2.5 release
  4. Vault subfolder scope issue 1118
  5. Claude Code hooks issue 1137
  6. User-scope MCP issue 1147
  7. Escaped linked-path issue 1230
  8. Claudian repository activity

More ai tools reviews

SkillSpector · robin · mjlab · MoGe · awesome-design-md · Code-as-World · the whole board →