On-demand Obsidian vault access for AI coding assistants

Why Hive?

Every session starts from scratch.

Your AI assistant doesn’t remember that you chose PostgreSQL over MySQL last month. Or that your deploy pipeline has a quirk with Redis cache. You end up repeating yourself, pasting the same context, stuffing everything into a giant CLAUDE.md that eats thousands of tokens before you even ask a question.

Hive fixes this.

You keep a folder of Markdown files — project decisions, architecture notes, lessons learned, task lists. Hive lets your assistant query them on demand. Only what’s relevant, when it’s relevant.

But the real power isn’t per-project memory.

It’s the shared practices. You define your coding standards, architecture patterns, and review checklists once. Every project — personal side projects, your day job, your team’s repos — follows the same playbook. That consistency compounds. And it’s what actually makes you faster.

One more thing: this doesn’t have to be an Obsidian vault. Any folder with .md files works. Your knowledge lives in plain files you control, not locked inside a tool.

Features

13 Tools

Query, search, write, patch, and list vault content. Delegate tasks to a worker model. Track health and usage.

5 Resources

MCP resources for projects, health metrics, context, tasks, and lessons — directly consumable by AI clients.

4 Prompts

Built-in protocols for retrospectives, delegation, vault sync, and benchmarking.

Worker Routing

One OpenAI-compatible worker endpoint, one attempt, no hidden fallback. Failures are classified so the caller decides where to route.

Quick Install

Claude Code

claude mcp add -s user hive -- uvx --upgrade hive-vault

Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.hive-vault]
command = "uvx"
args = ["--upgrade", "hive-vault"]

Gemini CLI

gemini mcp add -s user hive-vault uvx -- --upgrade hive-vault

Copilot (VS Code)

Add to .vscode/mcp.json:

{
  "servers": {
    "hive-vault": {
      "command": "uvx",
      "args": ["--upgrade", "hive-vault"]
    }
  }
}

OpenCode

Add to ~/.config/opencode/opencode.jsonc:

{
  "mcp": {
    "hive": {
      "type": "local",
      "command": ["uvx", "--upgrade", "hive-vault"],
      "enabled": true
    }
  }
}

No cloning, no venv, no setup. Learn more →

Recommended Workflow

The highest-value setup:

1. Obsidian — local-first knowledge base, Markdown native, 1M+ community
2. Obsidian Git — auto-commits vault changes on a schedule (5–10 min recommended)
3. Hive — bridges your vault to any AI coding assistant via MCP

Your assistant writes to the vault → Obsidian Git auto-commits → next session, everything is there. No manual sync. Write-heavy flows need no extra flags: Hive defers commits to a reconciler tick by default, and can hand off to the plugin entirely; see Configuration → Recommended configuration.

Hive works with any Markdown directory — Obsidian is recommended, not required.

Guides

• Benchmarks — token savings data and max_lines calibration.