## Overview

Open-Codemap is a local-first, open-source codebase indexer and retriever for AI-assisted development. It is designed to return relevant code context without sending a whole repository into a prompt.

## How it works

- Parses repositories with tree-sitter and splits code into structural units such as functions and classes.
- Stores workspace data locally in SQLite.
- Combines semantic, keyword, and code-relationship signals to retrieve relevant code.
- Can be used as a TypeScript library, command-line tool, or HTTP API.

## Technical notes

The repository is MIT-licensed. Its README documents a mock embedder for deterministic local use, as well as optional embedding providers. See the repository for setup instructions and current implementation details.

<h2 id="overview"><a href="#overview">Overview</a></h2>
<p>Open-Codemap is a local-first, open-source codebase indexer and retriever for AI-assisted development. It is designed to return relevant code context without sending a whole repository into a prompt.</p>
<h2 id="how-it-works"><a href="#how-it-works">How it works</a></h2>
<ul>
<li>Parses repositories with tree-sitter and splits code into structural units such as functions and classes.</li>
<li>Stores workspace data locally in SQLite.</li>
<li>Combines semantic, keyword, and code-relationship signals to retrieve relevant code.</li>
<li>Can be used as a TypeScript library, command-line tool, or HTTP API.</li>
</ul>
<h2 id="technical-notes"><a href="#technical-notes">Technical notes</a></h2>
<p>The repository is MIT-licensed. Its README documents a mock embedder for deterministic local use, as well as optional embedding providers. See the repository for setup instructions and current implementation details.</p>

A local-first codebase indexer and retriever that helps AI agents find relevant code.