How to Run Claude Code Directly Inside Obsidian with Agentic Copilot

Install the Agentic Copilot plugin to run Claude Code inside Obsidian, eliminating context switching between your notes and terminal.

GAla Smith & AI Research Desk·1d ago·4 min read·4 views·AI-Generated

Source: github.comvia hn_claude_code, gn_mcp_protocolCorroborated

What It Does — Claude Code in Your Knowledge Base

Agentic Copilot is an open-source Obsidian plugin that bridges your note-taking environment with the agentic CLI tools you already use. Instead of shipping its own LLM integration, it connects directly to tools like Claude Code, Opencode, or Gemini CLI that are already installed on your machine.

The plugin auto-detects available CLI agents from your PATH and provides a chat interface within Obsidian's sidebar. Every prompt automatically includes context from your active file, text selection, and vault path — giving the agent immediate context about what you're working on.

Why This Matters for Claude Code Users

If you use Obsidian for documentation, planning, or technical notes while developing with Claude Code, you've likely experienced the friction of switching between applications. You might have your project notes in Obsidian while running claude code commands in a separate terminal.

Agentic Copilot — Claude Code running inside Obsidian

This plugin eliminates that context switching. You can:

Ask Claude Code questions about your notes directly from Obsidian
Get explanations of code snippets you've pasted into your vault
Use Claude Code's slash commands (/commit, /review-pr, /compact) without leaving your knowledge base
Maintain the exact same Claude Code configuration and API keys you use in your terminal workflow

How To Set It Up (3 Minutes)

First, ensure you have Claude Code installed globally:

npm install -g @anthropic-ai/claude-code

Since the plugin isn't yet in the Community Plugins directory, you'll need to install it manually:

Download the latest release from GitHub
Extract the folder to your Obsidian vault's .obsidian/plugins/ directory
Enable the plugin in Obsidian Settings → Community Plugins
Restart Obsidian

Once installed, click the bot icon in the ribbon or use Cmd/Ctrl+P and search for "Agentic Copilot: Open chat panel." The plugin will automatically detect your installed Claude Code and you're ready to go.

Key Features That Match Your Terminal Workflow

Native Slash Commands

Type / in the chat input to autocomplete Claude Code's native commands. The plugin pulls these directly from your CLI tool, so you get the exact same functionality as in your terminal.

Inline Diffs with Approval

When Claude Code suggests file changes, they appear as inline diffs with Accept/Reject buttons. No changes are applied without your confirmation (unless you enable auto-apply in settings).

Context-Aware Prompts

Every prompt automatically includes:

Your active file content
Any selected text
Your vault's file structure
Available tags from your vault

This means you can select a code snippet in your notes and right-click → "Explain Selection" to get Claude Code's analysis without copying anything.

Multiple Independent Sessions

Open multiple chat panels, each with its own agent session. Use different agents in different panels, or run parallel conversations with the same one.

When This Plugin Shines

Documentation-Driven Development: When you're writing technical documentation in Obsidian and need to generate or explain code examples
Project Planning: Use Claude Code to help break down complex projects you're outlining in your vault
Learning & Note-Taking: Get instant explanations of concepts you're documenting without switching contexts
Code Review Preparation: Paste code snippets into Obsidian and use Claude Code's /review-pr command to analyze them

Limitations to Know

The plugin is a thin orchestration layer — it doesn't add new functionality to Claude Code itself. You're getting the exact same Claude Code you use in your terminal, just with a better UI for Obsidian workflows.

Since it's awaiting approval for the Community Plugins directory, you'll need to manually install and update it for now. The developer is actively seeking feedback and contributions.

Try This Today

If you're already using both Obsidian and Claude Code, this plugin is worth the 3-minute setup. The context switching reduction is immediate and noticeable. Start by:

Installing the plugin manually
Opening a technical note in your vault
Selecting a code block and right-clicking → "Explain Selection"
Using /help to see all available Claude Code commands

The seamless integration means every improvement to Claude Code automatically lands in your Obsidian workflow — no plugin updates required.

Following this story?

Get a weekly digest with AI predictions, trends, and analysis — free.

AI Analysis

Claude Code users who work with Obsidian should install this plugin immediately. The setup takes minutes and eliminates the most frustrating part of documentation-driven development: switching between your notes and terminal. Change your workflow: Instead of copying code snippets from Obsidian to a terminal, use the right-click context menu directly on selected text. The "Ask Agent" and "Explain Selection" options will become your primary interface for quick questions. Configure the plugin to match your terminal habits. If you use specific Claude Code flags regularly, check if they're available through slash commands. The plugin pulls commands directly from your CLI, so your existing muscle memory transfers perfectly. Consider creating a dedicated Obsidian workspace tab with the Agentic Copilot panel always open. This creates a persistent Claude Code session that's aware of everything you're working on in your vault.

#workflow-optimization #cli-integration #claude-code #obsidian-plugin

Mentioned in this article

Claude Code Obsidian OpenCode Agentic Copilot Gemini CLI

Enjoyed this article?

Get the weekly AI intelligence briefing