Claudian
github.com/yishentu/claudian- Category
- AI Agents
- Rank
- No. 232Tools index
- Pricing
- Open Source
- Type
- TOOL
- Builder
- yishentu
- GitHub
- 15.2k stars
- Latest release
- 2.2.6
- Date
About
An Obsidian plugin that embeds AI coding agents like Claude Code directly into your vault, turning your notes into an interactive coding workspace. The AI can read, write, edit, and search files in your vault while providing features like inline editing, slash commands, and multi-step workflows.
What it does
Claudian makes Obsidian the control surface for several installed coding-agent harnesses. You can chat in a sidebar, request edits at the cursor or selected text, preview word-level changes, reference notes and external files, reuse prompts and skills, and approve plans before implementation.
Why it's ranked here
The appeal is breadth with practical safeguards. Five agent families share one Obsidian experience, while plan approval, diff previews, sessions, tabs, provider settings, and startup diagnostics address everyday work. Its provider-neutral architecture and explicit test scripts suggest more than a thin chat wrapper.
What's good
It preserves familiar agent workflows while adding note-native controls. Inline edits show word-level diffs before acceptance. Mentions can supply vault files, external files, and subagents. Sessions support multiple tabs or a persistent manager. Ten locales, scoped prompts, skills, configurable providers, and native MCP configuration broaden real use.
Tradeoffs
Claudian requires Obsidian on desktop, a separately installed supported agent harness, and a compatible subscription or API provider. GUI applications may not inherit the correct command search path, especially with Node version managers. Prompts, attachments, images, and tool outputs leave the machine for the selected provider.
How to use it well
Choose it when notes, specifications, and implementation context already live in an Obsidian vault. Use plan mode for larger changes, inline editing for focused prose or code updates, and separate tabs for concurrent threads. It does not replace an agent harness, provider account, standalone editor, or mobile workflow.
Technical notes+
src/main.ts is the Obsidian plugin entry point and wires provider registration, chat views, inline editing, session persistence, settings, lifecycle cleanup, and startup profiling. package.json defines a TypeScript and esbuild toolchain, Node >=24 <25, Jest unit and coverage scripts, an architecture-boundary test, linting, and type checking. src/i18n/i18n.ts lazily loads ten locale dictionaries with English fallback. src/utils/env.ts searches platform-specific binary locations and handles Node-dependent CLI launchers. src/utils/path.ts normalizes environment, home, MSYS, Windows, and vault paths. src/utils/diff.ts converts structured patches, unified diffs, replacement edits, and tool inputs into displayable line changes and counts.
Observed
- License
- MIT
- Primary language
- TypeScript
- Install surface
- Obsidian Community Plugins, with source installation through npm and an esbuild production build
- Interface
- Obsidian desktop plugin with sidebar chat, command palette actions, hotkey-driven inline editing, and native CLI-managed MCP connections
- Agent harnesses
- Claude Code CLI, Codex CLI, Grok Build, OpenCode, and Pi
- Platform support
- Desktop Obsidian on macOS, Linux, and Windows
- Runtime requirement
- Obsidian 1.7.2 or newer; development package declares Node >=24 <25
- Validation surface
- Scripts cover Jest unit tests, coverage, architecture boundaries, linting, type checking, and startup performance
Read from README.md, package.json, src/main.ts, src/i18n/i18n.ts, src/utils/env.ts, src/i18n/types.ts, src/utils/date.ts, src/utils/diff.ts, src/utils/html.ts, src/utils/path.ts, src/utils/abort.ts, src/utils/agent.ts, src/utils/error.ts, src/shared/icons.ts, src/utils/canvas.ts.
What it can do
Read and analyze files in Obsidian vault
Files in Obsidian vault → File content analysis and understanding
Write new files to vault
AI-generated content or user specifications → New files created in vault
Edit existing files inline
Existing files and edit instructions → Modified file content
Search files across vault
Search queries or patterns → Matching files and content
Execute bash commands
Command line instructions → Command execution results
Process slash commands for AI interactions
Slash commands with parameters → Executed AI actions and responses
Execute multi-step coding workflows
Complex coding tasks or project requirements → Completed workflow with multiple file operations
Generate code from natural language prompts
Natural language coding requests → Generated code files or snippets
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.