← all repositories
RAIT-09/obsidian-agent-client

Turn your Obsidian vault into a control room for AI agents

An Obsidian plugin that pipes Claude Code, Codex, and Gemini CLI directly into your notes via the Agent Client Protocol.

2.4k stars TypeScript Coding AssistantsAgents
obsidian-agent-client
Velocity · 7d
+22
★ / day
Trend
accelerating
star history

What it does

This plugin embeds AI agents—Claude Code, Codex, Gemini CLI, and others—directly into Obsidian as chat interfaces. It uses Zed’s Agent Client Protocol (ACP) to spawn local agent processes, letting you reference notes with @notename, paste images, run slash commands, and export conversations back into Markdown. Think of it as a persistent terminal panel that happens to speak both AI and Obsidian.

The interesting bit

Instead of reinventing the wheel with yet another LLM wrapper, it piggybacks on the CLI tools you already installed. The plugin acts as a thin client: it hands off to local node processes running ACP adapters, so agents retain their native MCP servers and terminal access without extra plugin configuration.

Key highlights

  • Multi-session support: run several agents in parallel across separate views
  • Native note context: mention vault files directly in chat with @ syntax
  • Terminal integration: agents can execute shell commands and pipe results back
  • MCP passthrough: agents bring their own tool servers—no duplicate setup in Obsidian
  • Floating chat window plus full conversation history with forking

Caveats

  • Requires installing external CLI tools and ACP adapters manually, then pointing the plugin to their absolute paths
  • Needs a local Node.js installation; the plugin itself is just the Obsidian front-end

Verdict

Worth a look if you already live in Obsidian and want your coding agents to live there too. Skip it if you were hoping for a one-click, fully self-contained AI chatbot.

Frequently asked

What is RAIT-09/obsidian-agent-client?
An Obsidian plugin that pipes Claude Code, Codex, and Gemini CLI directly into your notes via the Agent Client Protocol.
Is obsidian-agent-client open source?
Yes — RAIT-09/obsidian-agent-client is open source, released under the Apache-2.0 license.
What language is obsidian-agent-client written in?
RAIT-09/obsidian-agent-client is primarily written in TypeScript.
How popular is obsidian-agent-client?
RAIT-09/obsidian-agent-client has 2.4k stars on GitHub and is currently accelerating.
Where can I find obsidian-agent-client?
RAIT-09/obsidian-agent-client is on GitHub at https://github.com/RAIT-09/obsidian-agent-client.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.