dolphin

<p align="center"> <h1 align="center">🐬 Dolphin</h1> <p align="center"> <strong>Hybrid search across all your repositories.</strong><br/> </p> <p align="center"> <a href="https://pypi.org/project/pb-dolphin/"></a> <a href="https://www.npmjs.com/package/dolphin-mcp"></a> <a href="https://opensource.org/licenses/MIT"></a> </p> </p>

---

Dolphin indexes your repositories and lets you perform hybrid (semantic + keyword) search across them.

# Install
uv pip install pb-dolphin

# Set your OpenAI key (used for embeddings)
export OPENAI_API_KEY="sk-..."

# Initialize, add a repo, and search
dolphin init
dolphin add-repo my-project /path/to/project
dolphin index my-project
dolphin search "database connection pooling"

Dolphin indexes your code with language-aware chunking, embeds it, and returns ranked results.

Want live re-indexing as you edit files? Start the server:

dolphin serve

A small companion MCP server is available at bunx dolphin-mcp. Add this to your AI app's MCP config:

{
  "mcpServers": {
    "dolphin": {
      "command": "bunx",
      "args": ["dolphin-mcp"]
    }
  }
}

Make sure dolphin serve is running, and your agent can now search, retrieve chunks, and read files from your indexed repos.

Additionally, a Claude skill is available in this repo's marketplace as a personal Plugin.

  You / Agent
        |
        v
  ┌───────────────────────────────────────┐
  │             Dolphin                   │
  │                                       │
  │   CLI ─── REST API ─── MCP Bridge     │
  │               |                       │
  │        ┌──────┴──────┐                │
  │        v             v                │
  │