Gemdex — Semantic Code Search

Why Gemdex

Loading a whole repo into an LLM's context every turn is slow, expensive, and forgetful. Gemdex finds the right code first, then hands only those chunks to your agent.

• 🧠 Semantically smart — AST-aware chunks embedded with Gemini Embedding 2 (8K context, 3072 dim, Matryoshka-resizable).
• 💸 Token-cheap — agents query natural language, get back targeted file:line hits instead of dragging in whole files.
• 🔌 Plug-and-play — speaks MCP over stdio, so any compatible client (Claude Code, Cursor, Codex CLI, Windsurf, Cline, Continue, Zed…) can use it instantly.
• 🌐 Local-first — runs against your own Milvus (Docker) — no SaaS, no telemetry, no third-party hops.
• ♻️ Always fresh — incremental Merkle-tree change detection + an optional file-trigger watcher keep the index in sync as you code.

See it in action

Ask your agent:

Find the retry-with-backoff helper.

…and instead of grep-spraying or stuffing your repo into the prompt, Gemdex hands back the three files that actually implement it.

Quickstart (under a minute)

1. Get Milvus running (local Docker)

# ~/milvus/docker-compose.yml
services:
  milvus:
    container_name: milvus-standalone
    image: milvusdb/milvus:v2.5.10
    environment:
      ETCD_USE_EMBED: "true"
      ETCD_DATA_DIR: /var/lib/milvus/etcd
      ETCD_CONFIG_PATH: /milvus/configs/embedEtcd.yaml
      COMMON_STORAGETYPE: local
      DEPLOY_MODE: STANDALONE
    volumes:
      - ./volumes/milvus:/var/lib/milvus
      - ./embedEtcd.yaml:/milvus/configs/embedEtcd.yaml
      - ./user.yaml:/milvus/configs/user.yaml
    ports:
      - "19530:19530"
      - "9091:9091"
      - "2379:2379"
    command: ["milvus", "run", "standalone"]

cd ~/milvus && docker compose up -d

2. Wire Gemdex into your agent

Claude Code (one-command plugin install — recommended):

/plugin marketplace add anand-92/gemdex
/plugin install gemdex@gemdex

You'll be prompted for GEMINI_API_KEY and MILVUS_ADDRESS (default localhost:19530). Sensitive values are stored in your OS keychain. The plugin ships:

• the gemdex MCP server (no local checkout — runs via npx -y gemdex-mcp@latest),
• a code-search skill that nudges Claude to prefer search_code over Grep/Glob for semantic queries, and
• a PostToolUse hook that auto-reindexes after every Edit/Write/MultiEdit.

See plugin/README.md for the full layout.

Claude Code (manual, no plugin):

claude mcp add gemdex \
  -e GEMINI_API_KEY=your-key \
  -e MILVUS_ADDRESS=localhost:19530 \
  -- npx -y gemdex-mcp@latest

Any other MCP client (Cursor, Codex CLI, Windsurf, Cline, Continue, Zed…):

{
  "mcpServers": {
    "gemdex": {
      "command": "npx",
      "args": ["-y", "gemdex-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-key",
        "MILVUS_ADDRESS": "localhost:19530"
      }
    }
  }
}

3. Index, then ask

Index this codebase.

Search for the websocket reconnection logic.