Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 13 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,9 +34,9 @@ Add Semble to Claude Code (requires [uv](https://docs.astral.sh/uv/getting-start
claude mcp add semble -s user -- uvx --from "semble[mcp]" semble
```

Then ask Claude Code questions about the codebase, e.g. `How is authentication handled in this project?`. Claude Code will automatically use Semble to find the relevant code and answer the question.
Once added, your agent will automatically use Semble whenever it needs to find relevant code. Instead of having to use grep with a keyword (e.g. `"authentication"`) and reading full files, it can query in natural language (e.g. `"How is authentication handled?"`) and immediately get back only the relevant context.

Using another agent harness? See [MCP Server](#mcp-server) for setup instructions for Codex, OpenCode, Cursor, and other MCP clients.
Using another agent harness? See [MCP Server](#mcp-server) for setup instructions for Codex, OpenCode, Cursor, and other MCP clients. To update Semble, see [Updating](#updating).

## Main Features

Expand Down Expand Up @@ -94,8 +94,6 @@ Add to `~/.cursor/mcp.json` (or `.cursor/mcp.json` in your project):
}
```

To upgrade to a newer version of Semble, run `uv cache clean semble` and restart your MCP client.

### Tools

| Tool | Description |
Expand Down Expand Up @@ -157,6 +155,7 @@ pip install semble # Install with pip
uv add semble # Install with uv
```


Semble also ships as a standalone CLI for use outside of MCP. This is useful in scripts, sub-agents, or anywhere you want search results without an MCP session.

```bash
Expand All @@ -177,6 +176,16 @@ semble find-related src/auth.py 42 ./my-project

If `semble` is not on `$PATH`, use `uvx --from "semble[mcp]" semble` in its place.

### Updating

To update/upgrade Semble to the latest version:

```bash
pip install --upgrade semble # with pip
uv add semble --upgrade # with uv
uv cache clean semble # for MCP users (restart your MCP client after)
```

## Python API

Semble can also be used as a Python library for programmatic access, useful when building custom tooling or integrating search directly into your own code.
Expand Down
3 changes: 2 additions & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ dependencies = [
"vicinity>=0.4.4",
"numpy>=1.24.0",
"bm25s>=0.2.0",
"chonkie[code]==1.6.2",
"chonkie[code]!=1.6.3",
"pathspec>=0.12",
]

Expand Down Expand Up @@ -143,3 +143,4 @@ exclude_also = ["if __name__ == .__main__.:", "@abstractmethod"]

[tool.uv]
exclude-newer = "1 week"
constraint-dependencies = ["tree-sitter-language-pack!=1.6.3"] # no MacOS wheels
2 changes: 1 addition & 1 deletion src/semble/version.py
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
__version_triple__ = (0, 1, 2)
__version_triple__ = (0, 1, 3)
__version__ = ".".join(map(str, __version_triple__))
Loading
Loading