LibreAI / Dev Tools / semble
// devtools · MinishLab/semble

semble

Fast, accurate semantic code search for agents — about 99% fewer tokens than grep plus read.

★ 6.2k stars⑂ 273 forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

semble is an open-source dev tools project by MinishLab (MinishLab/semble on GitHub). It has 6,192 GitHub stars and 273 forks, is released under the MIT license, and was last updated on GitHub on 8 October 2026.

GitHub stars
6,192
Forks
273
License
MIT
Last updated on GitHub
8 October 2026
Category
Dev Tools
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify what your agent wastes time on

    If your agent burns tokens grepping and reading files to find code, Semble is the retrieval layer that replaces that.

  2. Install Semble

    Install it as a uv tool and run the installer to wire it into your agent.

  3. Configure the integration

    Choose the MCP server, CLI instructions, or the dedicated semble-search sub-agent for your agent setup.

  4. Run your first search

    Search a local path or a remote git URL in natural language and inspect the returned chunks and your token savings.

// features

Why people love it

Semantic plus lexical retrieval

Combines embedding search with lexical matching, adaptively weighting symbol-like queries versus natural-language questions.

MCP server for agents

Runs as an MCP server with search and find_related tools; repos are indexed on demand and cached, and local paths re-index on file changes.

Token efficient by design

Returns only relevant chunks instead of whole files — the project reports about 99% fewer tokens than grep+read, and semble savings shows your totals.

Fast on CPU

Indexes an average repo in about 500 ms and answers queries in about 1 ms on CPU, per the project's benchmarks.

Local and remote repos

Search a local directory, an https git URL, or several repos at once; content types include code, docs, config or all.

Zero-setup operation

No API keys, GPU or external services required; a .sembleignore file controls what gets indexed.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone Semble if you want the source; most users install the tool in the next step.

    git clone https://github.com/MinishLab/semble.git
    cd semble
  2. Install Semble

    Install it as a uv tool and run its installer to set up your agent integration.

    uv tool install semble
    semble install
  3. Search a codebase

    Search a local repo (the index is built and cached automatically) or a remote one.

    semble search "authentication flow" ./my-project
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains Semble?

Semble is maintained by MinishLab (the Minish team), with docs at minish.ai.

Is Semble free?

Yes — it is open source under the MIT license.

Does it need a paid API key?

No. Semble runs locally on CPU with its own models and needs no API keys, GPU or external services.

How does it compare to grep or a vector database?

Grep matches text only and forces the agent to read whole files; Semble returns ranked, relevant chunks from a semantic index, purpose-built for agent consumption.

How do I get started?

uv tool install semble, run semble install, then semble search with a natural-language query against your repo.

// keep exploring

Similar tools

Dev Tools

grepai

grepai: semantic code search and call graphs for AI agents, running 100% locally on your machine.

★ 1.9k starsMIT
View guide →
Dev Tools

cocoindex-code

Lightweight AST-based semantic code search CLI (ccc) that makes coding agents faster and cheaper

★ 2.8k starsApache-2.0
View guide →
Dev Tools

ygrep

Fast, local, indexed code search built for AI assistants.

★ 60 starsMIT
View guide →
Dev Tools

probe

Semantic code search for AI — ripgrep speed with tree-sitter AST parsing.

★ 722 starsApache-2.0
View guide →
Dev Tools

SocratiCode

Enterprise-grade codebase intelligence for AI agents — hybrid semantic search over 40M+ LOC, locally.

★ 3.3k starsAGPL-3.0
View guide →
Dev Tools

zvec-grep

zvec-grep (zg): one local CLI unifying ripgrep-style exact search, BM25, and semantic vector search

★ 4.0k starsApache-2.0
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if semble is not the right fit.

Get semble

Free and open — grab the source, star the repo, and start creating.