obsidian-agent-client
Bring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.
The Agent Client plugin for Obsidian brings AI agents like Claude Code, Codex, and Gemini CLI directly into your Obsidian vault through the Agent Client Protocol (ACP). It enables natural interaction with AI assistants inside your notes, allowing you to reference vault files with @ mentions, run multiple agent sessions side-by-side, and embed live agent conversations within notes. The plugin surfaces all agent capabilities—MCP servers, slash commands, terminal access—without requiring additional configuration, while providing permission controls for every agent action.
Key Features
Use Cases
- 01Interacting with Claude Code to refactor code projects while cross-referencing technical notes in your vault
- 02Running parallel sessions with different AI agents to compare responses on the same research question
- 03Embedding a persistent coding assistant inside project documentation notes for context-aware help
- 04Using Gemini CLI to analyze writing drafts while pulling in reference materials from linked notes
- 05Executing terminal commands through agents with live output visible in the chat interface
- 06Broadcasting the same prompt to multiple agents simultaneously to evaluate different model approaches
Related Plugins
View moreandrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
claude-mem
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Understand-Anything
Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
rtk
CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies
obsidian-agent-client — FAQ
What is the Agent Client plugin for Obsidian?+
It's an Obsidian community plugin that integrates AI agents supporting the Agent Client Protocol (ACP)—including Claude Code, Codex, and Gemini CLI—directly into your note-taking workspace. The plugin lets you chat with agents in sidebars, tabs, or embedded within notes, and reference vault files using @ mentions.
How do I install the Agent Client plugin?+
Open Obsidian Settings, navigate to Community Plugins → Browse, search for 'Agent Client', then click Install and Enable. After enabling the plugin, you'll need to install and authenticate your chosen AI agent separately, following its specific setup guide.
Which AI agents work with this plugin?+
The plugin includes presets for Claude Code, Codex, Gemini CLI, Mistral Vibe, OpenCode, Kiro, and Hermes Agent. You can also add any custom ACP-compatible agent without waiting for a plugin update.
Do I need API keys to use this plugin?+
API key requirements depend on the specific agent you're using. Each agent (Claude Code, Gemini CLI, etc.) has its own authentication and setup process, which you must complete separately before using it through the plugin.
Is the Agent Client plugin free?+
The plugin itself is open source under the Apache 2.0 license and free to use. However, the AI agents you connect to (like Claude Code or Gemini CLI) may have their own costs or subscription requirements depending on the provider.
Can I use this plugin on mobile?+
No, Agent Client is a desktop-only plugin because it launches locally installed AI agents as child processes and requires terminal access for full functionality.
How do I install obsidian-agent-client?+
Open the source repository on GitHub and follow its README. obsidian-agent-client is a plugin — MCP Agents Market links you directly to the official repo.
Is obsidian-agent-client free?+
obsidian-agent-client is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.