New Plugin: Agent Client - "Bring Claude Code, Codex & Gemini CLI inside Obsidian"

Share & showcase
1

I’m excited to share my first Obsidian plugin — Agent Client, which brings AI coding agents directly into your note-taking workflow.

output
Background

I’ve been using AI agents like Claude Code and Codex for various tasks — from organizing research notes to automating workflows and solving complex problems. They’re incredibly powerful tools, but I found myself constantly switching between Obsidian (where I manage all my knowledge) and the terminal (where agents run). Every time I wanted an agent to help with something vault-related, I had to manually copy-paste content or explain context from scratch.

I wanted agents that could naturally understand my vault structure, reference my notes, and work alongside my existing workflow — without leaving Obsidian.

That’s when I discovered Zed’s Agent Client Protocol (ACP), which provides a clean interface for connecting to various AI agents. I decided to build a plugin around it, creating a bridge between Obsidian’s knowledge management capabilities and the power of AI agents.

What Agent Client does:

  • Native Agent Integration: Connect Claude Code, Codex, Gemini CLI, or any ACP-compatible agent (like Qwen Code, OpenCode) directly inside Obsidian
  • Vault-Aware Conversations: Use @notename or @[[note name]] to reference any note in your vault during conversations. You can even mention specific text selections
  • Auto-Mention Mode: Optionally include the current note’s context automatically in every message — perfect for iterative editing workflows
  • Keyboard-Driven Workflow: Full command palette integration lets you switch agents, start new chats, manage permissions, and cancel responses without touching the mouse
  • Tool Execution: Let agents execute terminal commands and use MCP (Model Context Protocol) tools to automate complex workflows
  • Session Management: Automatically export chat sessions as notes (on new chat or close), preserving your conversations as part of your vault
  • WSL Support: Full compatibility with Windows Subsystem for Linux environments

Installation

Currently available via BRAT: GitHub Repository

I’ve submitted it to the Community Plugin Store and it’s awaiting review.

Fair Warning
The plugin requires setting up external agent binaries (like Claude Code), which involves some command-line configuration. I’ve included setup guides in the repository to make this as smooth as possible. Once configured, everything runs seamlessly within Obsidian.

Looking Forward

I’d love to hear your thoughts and use cases! If you have ideas for features, find bugs, or just want to discuss how AI agents could better integrate with your Obsidian workflow, please share in this thread or on GitHub.

Don’t forget to star the repo if you find it useful!

2 Likes
2

Very cool! I’ve been working on solving this issue for myself.

I use OpenCode. I see slash command support, nice! What about tab to switch modes? And I’m curious about multi-session support? Could I have an instance of OpenCode running on each open tab? or multiple instances running best-of-n?

1 Like
3

Thanks for your interest!

Mode switching isn’t implemented yet, but since it’s defined in the Agent Client Protocol specification, I’m planning to tackle it soon — along with model switching features, it’s high on my priority list!

Regarding multi-session support, currently only a single instance can run at a time. However, your use case sounds really compelling — running multiple instances for best-of-n comparison is a fascinating idea. I really appreciate the feedback! I’ll add this to my roadmap and hopefully have updates soon.

2 Likes
4

Ofc, I’m eager to see these features implemented!

We’re turning Obsidian from a note-taking tool to a natural language IDE. Almost unbelievable that it’s possible now. (And to think I was using vanilla Apple notes MONTHS ago, haha). What a time to be alive!

1 Like