The power of Claude Code — without the terminal.

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.
→ Full setup guide with Claude Desktop install prompt
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.
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.
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.
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.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.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.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.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.Hyo connects to these services and nothing else:
api.anthropic.com) for the usage meter, refreshing the CLI's sign-in token (claude.ai) when it has expired.claude.ai). Only when you click Install, to download the official CLI installer.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.
Ev Chapman — teaching knowledge workers to build in partnership with AI.
Part of the College of Knowledge community.