Open-Codemap
A local-first codebase indexer and retriever that helps AI agents find relevant code.
01 / 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.
02 / 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.
03 / 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.
Related projects
ls ./projects →
Tunic Desktop
I built Tunic Desktop as a local-first AI workspace that brings streamed chat, flexible model providers, permission-aware tools, and project planning together.
Element Lens
A Chrome and Edge extension that turns a selected page element into context for an AI agent.