Skip to content
ToolOpen-source agent

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

  1. Skills, hooks, memory and security layer for coding agent harnesses

    • Freemium
    • Open-source agent
    • 305K GitHub stars
    • AI models and LLM tooling
  2. Web search, scraping and page interaction API for AI agents and developers

    • Freemium
    • Agent framework
    • 202K GitHub stars
    • Web search and scraping
  3. 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
  4. Code knowledge graph that gives coding assistants shared, source-linked context

    • Freemium
    • Open-source agent
    • 149K GitHub stars
    • Knowledge and memory
  5. Desktop environment for running several coding agents in parallel worktrees

    • Open source
    • Open-source agent
    • 127K GitHub stars
    • Coding
  6. Memory for coding agents that saves decisions and fixes, with optional hosted sync

    • Freemium
    • Open-source agent
    • 118K GitHub stars
    • Knowledge and memory