Installation

Install, update, and uninstall VecGrep

Requirements

• Python 3.12
• uv (recommended) or pip
• Claude Code

Python 3.12 is required — tree-sitter-languages does not yet have wheels for Python 3.13+.

Install

uv (recommended)

uv tool install --python 3.12 vecgrep

Register with Claude Code

Run once — works for every project:

claude mcp add --scope user vecgrep -- vecgrep

This registers VecGrep in your user config (~/.claude.json) so it’s available globally across all projects. Starts instantly — no download delay on Claude Code launch.

Update

uv

uv tool upgrade vecgrep

To install a specific version:

uv

uv tool install --python 3.12 vecgrep==2.0.0

After upgrading, restart Claude Code to pick up the new version.

Uninstall

uv

uv tool uninstall vecgrep

Then remove the MCP registration from Claude Code:

claude mcp remove vecgrep

To also wipe all indexes (vector + graph) stored on disk, delete the VecGrep data directory:

~/.vecgrep/

Dependencies (v2.0.0+)

VecGrep v2.0.0 adds networkx>=3.2 and tree-sitter==0.21.3 (pinned) for the knowledge graph index. Both are installed automatically — no extra steps required.