Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Hyo Claude Code Agent

Ev ChapmanEv Chapman5k downloads

Chat with Claude Code inside your vault.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates77

The power of Claude Code — without the terminal.

Hyo Claude Code Plugin

If you want to use Claude Code inside Obsidian but the terminal isn't your thing, Hyo gives you everything Claude Code can do — full agent capability, MCP tools, multi-step reasoning — wrapped in a clean chat interface right inside your notes.

No separate app, no extra billing — Hyo runs on your existing Claude login, not a pay-per-use API key. Just Claude, living in your vault.


Features

  • Multiple conversation tabs — run parallel conversations or keep different projects separate
  • Past sessions browser — pick up any previous conversation right where you left off
  • Usage tracking — see how much of your Claude plan you've used (5-hour window + 7-day)
  • Context window display — visual indicator of how much conversation context is in use
  • Model switcher — choose between Opus, Sonnet, and Haiku; 200K or 1M context
  • Permission modes — control what Claude can do: ask every time, auto-edit, or hands-off
  • Slash commands — load skills, compact your conversation, and more
  • File attachments — attach the file you're currently editing with one click, or any text/image file
  • Inline permission prompts — approve or deny Claude's tool requests without leaving the chat
  • Markdown rendering — Claude's responses render as rich markdown, not raw text

→ Full setup guide with Claude Desktop install prompt


Requirements

  • Obsidian on your computer. Hyo also runs on your phone or tablet, connected to your computer (see Mobile access in the docs).
  • A Claude account — Pro, Max, Team, or Enterprise (claude.ai)
  • Claude Code CLI (the plugin will walk you through installing it if needed)

Installation

Hyo is in Obsidian's community plugin directory.

Step 1: Install Hyo Open Hyo in the Obsidian plugin directory and click Add to Obsidian. Or in Obsidian, go to Settings → Community plugins → Browse, search for Hyo Claude Code Agent, and click Install.

Step 2: Enable it In Settings → Community plugins, turn on Hyo Claude Code Agent.

Already installed through BRAT? Remove Hyo from BRAT's list of beta plugins. Your settings stay, and Obsidian keeps Hyo up to date from now on.

Step 3: Open Hyo Click the chat icon in the ribbon, or run Hyo Claude Code Agent: Open chat panel from the command palette. To open it with a shortcut, assign one in Settings → Hotkeys. If Claude Code isn't installed yet, the plugin will show you exactly how to set it up.


How it works

Hyo runs Claude Code CLI as a background process and streams the conversation into Obsidian. Your vault root is Claude's working directory by default — so Claude can read and edit your notes, run tools, and use any MCP servers you've configured.

If your Claude project lives in a different folder, you can point Hyo there: Settings → Hyo Claude Code Agent → Advanced → Working directory.


What Hyo accesses, and why

Hyo is a front end for the Claude Code CLI, which runs on your computer. That's why, on desktop, it does things most Obsidian plugins don't. Everything below happens only in the desktop app. On a phone or tablet, Hyo talks to your own computer (see Mobile access) and touches nothing else on the device.

  • Runs programs (child_process). Hyo starts the claude CLI and talks to it over standard input and output. It also finds and updates the CLI (claude --version, claude update), opens the Claude sign-in, and, only if you turn on mobile access, runs the tailscale CLI to make your computer reachable from your phone.
  • Reads and writes files outside the vault (fs). Hyo reads Claude Code's own files in ~/.claude: past conversations, so they appear in Hyo's history, plus your skills, agents and settings. It writes Hyo's shared list of open conversations and pins there, and stores mobile access settings in ~/.hyo. Inside your vault, notes are read and written through Obsidian's API.
  • Reads your user name and environment. Hyo uses your home folder, PATH and shell to find the claude CLI where your terminal would. On a Mac, it reads your user name to look up Claude Code's sign-in in the Keychain (security find-generic-password) for the usage meter. Nothing is fingerprinted or sent anywhere.
  • Opens a local network port (net), only if you turn on mobile access. The gateway listens on 127.0.0.1 only, and Tailscale carries it privately to your phone. It's off by default.
  • Lists vault files. This feeds the note picker and finds the notes that note commands apply to.
  • Uses the clipboard. Hyo only writes to it, when you click a copy button. It never reads it.
  • Keeps device-local state in localStorage. Your open tabs on the phone are cached for offline start-up. A one-time move of open tabs from older versions of Hyo also reads it. Settings that belong to one device use Obsidian's own device storage.

Network use & privacy

Hyo connects to these services and nothing else:

  • Anthropic (Claude). The Claude Code CLI connects to Anthropic with your existing Claude login. Your messages, and any vault content you choose to share, go to Anthropic under your own account, subject to Anthropic's terms. Hyo reads your usage from Anthropic's API (api.anthropic.com) for the usage meter, refreshing the CLI's sign-in token (claude.ai) when it has expired.
  • Claude Code installer (claude.ai). Only when you click Install, to download the official CLI installer.
  • OpenAI (optional voice calls and dictation). Off by default. A voice call runs on OpenAI's GPT-Live: while it's on, your microphone audio and the conversation are sent to OpenAI, using an API key you provide. If you choose OpenAI for dictation, your dictated audio goes to OpenAI to be turned into text.
  • ElevenLabs (optional dictation). Off by default. If you choose ElevenLabs for dictation, your dictated audio is sent to ElevenLabs to be turned into text, using an API key you provide. Nothing else goes to ElevenLabs.
  • Your own computer (optional mobile access). The phone connects to your computer through your private Tailscale network. Nothing goes through a Hyo server, because there isn't one.
  • No telemetry. Hyo collects no analytics and sends nothing anywhere else.

Your API keys and settings are stored locally, in the plugin's data or on your computer, and are only ever sent to the service they belong to.


Built by

Ev Chapman — teaching knowledge workers to build in partnership with AI.

Part of the College of Knowledge community.

HealthExcellent
ReviewSatisfactory
About
Run Claude Code inside your vault via a built-in chat interface with multi-tab conversations and a past-sessions browser. Track usage and context, switch models, attach files, approve tool requests inline, and render Claude responses as rich Markdown.
AIAttachmentsMarkdown
Details
Current version
1.0.0
Last updated
2 days ago
Created
7 months ago
Updates
77 releases
Downloads
5k
Compatible with
Obsidian 1.7.2+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Author
Ev ChapmanEv Chapmanevielync
GitHubevielync
  1. Community
  2. Plugins
  3. AI
  4. Hyo Claude Code Agent

Related plugins

Consistent Attachments and Links

Move note attachments and update links automatically.

Nexus AI Chat Importer

Import AI chats from ChatGPT, Claude, Mistral Vibe, Perplexity, and Grok into Obsidian as clean Markdown notes.

Whisper

Speech-to-text using OpenAI Whisper.

Claudian

Embeds Claude Code/Codex and other local Agents as AI collaborators in your vault.

Linter

Format and style your notes. Linter can be used to format YAML tags, aliases, arrays, and metadata; footnotes; headings; spacing; math blocks; regular Markdown contents like list, italics, and bold styles; and more with the use of custom rule options.

Smart Connections

Find related notes and excerpts while writing. Your AI link building copilot displays relevant content in graph + list view. A local embedding model powers semantic search. Zero setup. No API key.

Fast Note Sync

Real-time sync of your vaults across server, mobile, and web; shareable with anyone; supports REST and MCP integrations to build your personal AI knowledge base.

Custom Frames

Turn web apps into panes using iframes with custom styling. Also comes with presets for Google Keep, Todoist and more.

ChatGPT MD

A seamless integration of ChatGPT, OpenRouter.ai and local LLMs via Ollama into your notes.

Share Note

Instantly share/publish a note, with the full theme and content exactly like you see in Obsidian. Data is shared encrypted by default, and only you and the person you send it to have the key.