kodit Docs

kodit: Code Indexing MCP Server

Installation

Please choose your preferred installation method. They all ultimately install the kodit cli, which contains the kodit MCP server and other tools to manage your data sources.

Docker 

docker run -it --rm registry.helix.ml/helix/kodit:latest

Always replace latest with a specific version.

pipx 

pipx install kodit

homebrew 

brew install helixml/kodit/kodit

uv 

uv tool install kodit

pip

Use this if you want to use kodit as a python library:

pip install kodit

Quick Start

Kodit has two key parts. A configuration CLI to manage what gets indexed and an MCP server to expose your code to an AI coding assistant.

  1. Index a local path: kodit index /path/to/your/code
  2. Or index a public git repository: kodit index https://github.com/pydantic/pydantic-ai
  3. Test retrieval on your index: kodit retrieve "test"
  4. Start an MCP server: kodit serve

Now browse to your AI coding assistant and add the MCP server. You will also need to tell your assistant to use this server in coding tasks, otherwise it won’t get called!

Integration with Cursor

Add the following to .cursor/mcp.json:

{
  "mcpServers": {
    "code-search": {
      "url": "http://localhost:8080/sse"
    }
  }
}

Now add the following prompt to .cursor/rules/kodit.mdc in your project directory:

---
description: 
globs: 
alwaysApply: true
---
You MUST use the code-search MCP tool and always include any file context the user has provided in the chat.

Alternatively, you can browse to the cursor settings and set this prompt globally.