Claude Code IDE For Obsidian

Connects the Claude Code CLI to Obsidian the same way the VS Code extension does: Claude can read your selection and open files, open files, show diffs you keep/reject, and run inside an embedded terminal.

Protocol is the WebSocket MCP variant reverse-engineered from the VS Code extension — compatible with coder/claudecode.nvim.

Build

npm install
npm run build        # -> main.js + styles.css
npm test             # protocol self-check (no Obsidian needed)

Install: copy main.js, styles.css, manifest.json into <vault>/.obsidian/plugins/obsidian-claude-code-ide/, then enable it in Settings → Community plugins.

Use

Enabling the plugin starts a WebSocket server on 127.0.0.1, writes ~/.claude/ide/<port>.lock, and is ready. Two ways to connect Claude:

• Embedded terminal (auto-connect): ribbon icon → Claude Code terminal, or the command palette. Spawns claude with the env vars already set; it connects on its own.
• Passive mode (no native deps): in any terminal, cd into the vault and run claude, then /ide → pick Obsidian.

node-pty (embedded terminal only)

The terminal needs node-pty, a native module that must match Obsidian's Electron ABI. It's an optional dependency — if it can't load, the terminal pane prints the passive-mode steps instead and everything else still works.

To enable it, rebuild against Obsidian's Electron:

npx electron-rebuild -v <obsidian-electron-version> -m node_modules/node-pty

Find the Electron version in Obsidian via Help → Debug info. Copy the rebuilt node_modules/node-pty next to main.js in the plugin folder.

Layout

File	Concern
src/ide-server.ts	WS server, JSON-RPC/MCP, auth, lock file (Obsidian-free, tested)
src/tools.ts	The 11 MCP tool handlers (Obsidian-free, tested)
src/main.ts	Plugin lifecycle + Obsidian EditorContext implementation + selection bridge
src/diff-modal.ts	openDiff keep/reject UI
src/terminal-view.ts	xterm.js + node-pty terminal

Not done

• executeCode / getDiagnostics — no Obsidian equivalent (getDiagnostics returns []).
• isDirty is always false (Obsidian autosaves; real dirty state isn't exposed).