miyomiyodocs← Home

Getting Started

miyo keeps your files on your computer and makes them available to every AI you use. In a few minutes you'll install the app, add your folders, and connect your AI apps so they can use your files.

Install miyo

Download miyo for macOS, Windows, or Linux and open it. miyo lives in your menu bar (or system tray on Windows) and quietly runs on your computer. Nothing leaves your device until you choose to connect an AI app.

Add your folders

Folders tell miyo which files it should know about. In the miyo dashboard, open the Sources tab, click + add a folder, and choose a folder. miyo reads through it, makes it searchable, and keeps up automatically as you add or change files.

Add as many folders as you like — you can pause, resume, or remove any of them from the Sources tab at any time.

Connect ChatGPT and Claude

This is where miyo shines: let ChatGPT and Claude search your files right from the apps you already use. miyo connects them through a secure link called the relay. Only your searches and the matching snippets pass through it — your full files always stay on your computer.

Turn on the connection

  1. In the dashboard, open the Connect tab.
  2. Click Sign in and finish signing in your browser (email, GitHub, or Google).
  3. Back in the app, switch on Enable tunnel and wait until it says Connected.
  4. Copy the MCP Server URL shown there (it looks like https://relay.miyo.md/mcp). You'll paste this into ChatGPT and Claude.

Add miyo to ChatGPT

  1. In ChatGPT, open Settings → Connectors (chatgpt.com/apps#settings/Connectors).
  2. Add a custom connector and paste your MCP Server URL.
  3. Click Connect and approve miyo when asked.

Now just mention @miyo in any chat to pull from your files.

Add miyo to Claude

  1. In Claude, open Settings → Connectors (claude.ai/settings/connectors).
  2. Add a custom connector and paste your MCP Server URL.
  3. Click Connect and approve miyo when asked.

Claude can now reach your files from the web.

Connect to Obsidian Copilot

If you use Obsidian Copilot (also from Brevilabs), you can point it at miyo so it uses your local miyo index for search, PDF parsing, and context — no cloud setup required, since both run on your machine.

Before you start: make sure the miyo app is running and that your Obsidian vault's folder is already added in miyo. Copilot uses the vault's folder name to find it in miyo. This feature lives under Copilot's Self-Host Mode, which requires a Copilot Plus lifetime license.

  1. In Obsidian, open Copilot settings → Copilot Plus.
  2. Expand Self-Host Mode and turn on Enable Self-Host Mode.
  3. Turn on Enable Miyo. (If miyo isn't running you'll see "Miyo app is not available. Please start the Miyo app and try again.")
  4. Confirm the scan prompt. Copilot registers the vault folder with miyo and indexes it.
  5. (Optional) Turn on Search everything in Miyo to search across all your miyo folders instead of just the current vault.

That's it — Copilot now searches and parses through miyo locally.

Connect Claude Code and Codex

Terminal coding agents like Claude Code and Codex can run shell commands, so the simplest way to give them your files is the miyo command line tool.

  1. In the dashboard, go to Access → CLI tools and click Install. This adds the miyo command to your terminal — restart your terminal afterward.
  2. Keep the miyo app running.
  3. Tell the agent it can use miyo by adding a line to your project's agent instructions — CLAUDE.md for Claude Code, AGENTS.md for Codex:
To search the user's local files, use the `miyo` CLI. Run `miyo --help` to see
the available commands.

The agent discovers the commands on its own and runs them whenever it needs context, reading the results straight from the terminal — nothing leaves your machine.

Prefer MCP? miyo also exposes a stdio MCP server via miyo mcp, handy for agents that can't run shell commands — like Claude Desktop, which you add to its claude_desktop_config.json with command: "miyo", args: ["mcp"].

What's next