
semble
Local code search for coding agents that returns only the relevant snippets
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- GitHub stars
- 6.4K
- Last commit
- 9 days ago
- Language
- Python
- License
- MIT
About semble
semble is an open-source AI tool for coding. It is available on CLI, macOS, Linux, Windows and self-hosted.
Semble indexes a repository in about half a second on average and answers queries in roughly a millisecond, all on CPU with no API keys or external services. Instead of grepping and reading whole files, an agent asks in plain language and receives just the matching chunks, which the project says uses about 99 percent fewer tokens.
Files are split into code-aware chunks with tree-sitter and scored by two retrievers: static Model2Vec embeddings and BM25. You can point it at a local path or a git URL, or several at once to search related repos together.
An interactive installer detects coding agents such as Claude Code, Cursor, Codex and Gemini CLI and sets up an MCP server, AGENTS.md instructions or a dedicated sub-agent.
What it does
- CPU-only indexing
- No GPU, API key or external service is needed.
- Two retrievers
- Combines Model2Vec embeddings with BM25.
- Remote repos
- Search a local path or git URL.
- MCP server
- Exposes search and find_related tools.
- Interactive installer
- Detects agents and enables integrations.
- Token-efficient output
- Returns only relevant chunks.
Good for
- Answer where authentication is handled in a repo
- Find code similar to a given location
- Cut token use in coding-agent sessions
- Search several related repositories together
Pricing
Open source
MIT licensed
Prices change. Check minish.ai before you buy.
semble FAQ
Which tools does the MCP server expose?
search and find_related.
Does it need an API key?
No; it runs on CPU.
How accurate is it?
The project reports an NDCG@10 of 0.854 on its benchmarks.
How do I install it?
Install uv, then run uv tool install semble and semble install.
Is semble free?
Yes. semble is open source, so you can use and self-host it for free.
What are the best alternatives to semble?
The closest alternatives to semble are ECC, firecrawl, ponytail, graphify and orca.
Alternatives to semble

Skills, hooks, memory and security layer for coding agent harnesses
- Freemium
- Open-source agent
- 305K GitHub stars
- AI models and LLM tooling

Web search, scraping and page interaction API for AI agents and developers
- Freemium
- Agent framework
- 202K GitHub stars
- Web search and scraping

Ruleset that makes AI coding agents write less code that still works
- Open source
- Open-source agent
- 192K GitHub stars
- AI models and LLM tooling

Code knowledge graph that gives coding assistants shared, source-linked context
- Freemium
- Open-source agent
- 149K GitHub stars
- Knowledge and memory

Desktop environment for running several coding agents in parallel worktrees
- Open source
- Open-source agent
- 127K GitHub stars
- Coding

Memory for coding agents that saves decisions and fixes, with optional hosted sync
- Freemium
- Open-source agent
- 118K GitHub stars
- Knowledge and memory