From abf51bb43de45faa50bac3dab37ee05ae45a8cec Mon Sep 17 00:00:00 2001 From: Pringled Date: Tue, 5 May 2026 11:04:00 +0200 Subject: [PATCH 01/14] Made bash clearer --- README.md | 28 +++++++++++++++------------- 1 file changed, 15 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 23518df..1fd0689 100644 --- a/README.md +++ b/README.md @@ -18,6 +18,7 @@ [Quickstart](#quickstart) • [MCP Server](#mcp-server) • +[Bash / Agent file](#bash--agent-file) • [CLI](#cli) • [Python API](#python-api) • [Benchmarks](#benchmarks) @@ -36,7 +37,7 @@ claude mcp add semble -s user -- uvx --from "semble[mcp]" semble 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. To update Semble, see [Updating](#updating). +Using another agent harness? See [MCP Server](#mcp-server) for setup instructions for Codex, OpenCode, Cursor, and other MCP clients. For sub-agents or setups without MCP, see [Bash / Agent file](#bash--agent-file). To update Semble, see [Updating](#updating). ## Main Features @@ -101,21 +102,12 @@ Add to `~/.cursor/mcp.json` (or `.cursor/mcp.json` in your project): | `search` | Search a codebase with a natural-language or code query. Pass `repo` as a git URL or local path. | | `find_related` | Given a file path and line number, return chunks semantically similar to the code at that location. | -### Sub-agent support -Claude Code and Codex CLI lazy-load MCP tool schemas, so sub-agents cannot call `mcp__semble__search` directly. The fix is to invoke semble through the [CLI](#cli) via Bash instead. +## Bash / Agent file -**Claude Code**: run this once in your project root: +An alternative to MCP is to invoke Semble via Bash. This is the only option for sub-agents, which cannot call MCP tools directly (Claude Code and Codex CLI lazy-load MCP schemas at the top-level agent only). -```bash -semble init -# or, if semble is not on $PATH: -uvx --from "semble[mcp]" semble init -``` - -This writes [`.claude/agents/semble-search.md`](src/semble/agents/semble-search.md). - -**Other tools (Codex, etc.)**: append the following to your `AGENTS.md`: +To add Bash support, append the following to your `AGENTS.md` or `CLAUDE.md`: ```markdown ## Code Search @@ -138,6 +130,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. +**Claude Code sub-agent**: Claude Code also supports a dedicated sub-agent, which gives more control over when and how Semble is invoked. Run this once in your project root: + +```bash +semble init +# or, if semble is not on $PATH: +uvx --from "semble[mcp]" semble init +``` + +This writes [`.claude/agents/semble-search.md`](src/semble/agents/semble-search.md). + ## Workflow 1. Start with `semble search` to find relevant chunks. From 2971c5e27f89142a5032544add8741e8c57017ae Mon Sep 17 00:00:00 2001 From: Pringled Date: Tue, 5 May 2026 11:07:13 +0200 Subject: [PATCH 02/14] Made bash clearer --- README.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index 1fd0689..ebb0154 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ [Quickstart](#quickstart) • [MCP Server](#mcp-server) • -[Bash / Agent file](#bash--agent-file) • +[Bash / AGENTS.md](#bash--agentsmd) • [CLI](#cli) • [Python API](#python-api) • [Benchmarks](#benchmarks) @@ -37,7 +37,7 @@ claude mcp add semble -s user -- uvx --from "semble[mcp]" semble 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. For sub-agents or setups without MCP, see [Bash / Agent file](#bash--agent-file). To update Semble, see [Updating](#updating). +Using another agent harness? See [MCP Server](#mcp-server) for setup instructions for Codex, OpenCode, Cursor, and other MCP clients. For sub-agents or setups without MCP, see [Bash / AGENTS.md](#bash--agentsmd). To update Semble, see [Updating](#updating). ## Main Features @@ -103,7 +103,7 @@ Add to `~/.cursor/mcp.json` (or `.cursor/mcp.json` in your project): | `find_related` | Given a file path and line number, return chunks semantically similar to the code at that location. | -## Bash / Agent file +## Bash / AGENTS.md An alternative to MCP is to invoke Semble via Bash. This is the only option for sub-agents, which cannot call MCP tools directly (Claude Code and Codex CLI lazy-load MCP schemas at the top-level agent only). @@ -130,7 +130,15 @@ semble find-related src/auth.py 42 ./my-project If `semble` is not on `$PATH`, use `uvx --from "semble[mcp]" semble` in its place. -**Claude Code sub-agent**: Claude Code also supports a dedicated sub-agent, which gives more control over when and how Semble is invoked. Run this once in your project root: +## Workflow + +1. Start with `semble search` to find relevant chunks. +2. Inspect full files only when the returned chunk is not enough context. +3. Optionally use `semble find-related` with a promising result's `file_path` and `line` to discover related implementations. +4. Use grep only when you need exhaustive literal matches or quick confirmation of an exact string. +``` + +**Claude Code sub-agent**: Claude Code also supports a dedicated sub-agent. Run this once in your project root: ```bash semble init @@ -140,14 +148,6 @@ uvx --from "semble[mcp]" semble init This writes [`.claude/agents/semble-search.md`](src/semble/agents/semble-search.md). -## Workflow - -1. Start with `semble search` to find relevant chunks. -2. Inspect full files only when the returned chunk is not enough context. -3. Optionally use `semble find-related` with a promising result's `file_path` and `line` to discover related implementations. -4. Use grep only when you need exhaustive literal matches or quick confirmation of an exact string. -``` - ## CLI Install Semble: From 5fcb0363982ec753fcdfd430cbb5db70bfcc3881 Mon Sep 17 00:00:00 2001 From: Pringled Date: Tue, 5 May 2026 11:11:08 +0200 Subject: [PATCH 03/14] Made bash clearer --- README.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index ebb0154..58601ea 100644 --- a/README.md +++ b/README.md @@ -29,6 +29,8 @@ Semble is a code search library built for agents. It returns the exact code snip ## Quickstart +### MCP + Add Semble to Claude Code (requires [uv](https://docs.astral.sh/uv/getting-started/installation/)): ```bash @@ -37,7 +39,18 @@ claude mcp add semble -s user -- uvx --from "semble[mcp]" semble 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. For sub-agents or setups without MCP, see [Bash / AGENTS.md](#bash--agentsmd). To update Semble, see [Updating](#updating). +Using another agent harness? See [MCP Server](#mcp-server) for setup instructions for Codex, OpenCode, Cursor, and other MCP clients. + +### Bash / AGENTS.md + +Install Semble and add the [code search snippet](#bash--agentsmd) to your `AGENTS.md` or `CLAUDE.md`: + +```bash +pip install semble # Install with pip +uv add semble # Or install with uv +``` + +To update Semble, see [Updating](#updating). ## Main Features From 3fba288b55c8d34568071117210045cca0873526 Mon Sep 17 00:00:00 2001 From: Pringled Date: Tue, 5 May 2026 11:14:16 +0200 Subject: [PATCH 04/14] Made bash clearer --- README.md | 16 ++++------------ 1 file changed, 4 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index 58601ea..81ab643 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ [Quickstart](#quickstart) • [MCP Server](#mcp-server) • -[Bash / AGENTS.md](#bash--agentsmd) • +[Bash / AGENTS.md](#bash-integration) • [CLI](#cli) • [Python API](#python-api) • [Benchmarks](#benchmarks) @@ -41,9 +41,9 @@ Once added, your agent will automatically use Semble whenever it needs to find r Using another agent harness? See [MCP Server](#mcp-server) for setup instructions for Codex, OpenCode, Cursor, and other MCP clients. -### Bash / AGENTS.md +### Bash integration -Install Semble and add the [code search snippet](#bash--agentsmd) to your `AGENTS.md` or `CLAUDE.md`: +Install Semble and add the [code search snippet](#bash-integration) to your `AGENTS.md` or `CLAUDE.md`: ```bash pip install semble # Install with pip @@ -116,7 +116,7 @@ Add to `~/.cursor/mcp.json` (or `.cursor/mcp.json` in your project): | `find_related` | Given a file path and line number, return chunks semantically similar to the code at that location. | -## Bash / AGENTS.md +## Bash integration An alternative to MCP is to invoke Semble via Bash. This is the only option for sub-agents, which cannot call MCP tools directly (Claude Code and Codex CLI lazy-load MCP schemas at the top-level agent only). @@ -163,14 +163,6 @@ This writes [`.claude/agents/semble-search.md`](src/semble/agents/semble-search. ## CLI -Install Semble: - -```bash -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 From 98a522cea116ff8ddd714ba22948145b2e6ad8fe Mon Sep 17 00:00:00 2001 From: Pringled Date: Tue, 5 May 2026 11:16:48 +0200 Subject: [PATCH 05/14] Made bash clearer --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 81ab643..14f6360 100644 --- a/README.md +++ b/README.md @@ -29,6 +29,8 @@ Semble is a code search library built for agents. It returns the exact code snip ## Quickstart +Semble can be used as an [MCP server](#mcp-server) or via [Bash / AGENTS.md](#bash-integration). Once set up, 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. + ### MCP Add Semble to Claude Code (requires [uv](https://docs.astral.sh/uv/getting-started/installation/)): @@ -37,11 +39,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 ``` -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. -### Bash integration +### Bash / AGENTS.md Install Semble and add the [code search snippet](#bash-integration) to your `AGENTS.md` or `CLAUDE.md`: From 8cd90279bbae75e7a5aeb1ad6b290e4875c05647 Mon Sep 17 00:00:00 2001 From: Pringled Date: Tue, 5 May 2026 11:20:33 +0200 Subject: [PATCH 06/14] Made bash clearer --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index 14f6360..b07e215 100644 --- a/README.md +++ b/README.md @@ -43,6 +43,8 @@ Using another agent harness? See [MCP Server](#mcp-server) for setup instruction ### Bash / AGENTS.md + + Install Semble and add the [code search snippet](#bash-integration) to your `AGENTS.md` or `CLAUDE.md`: ```bash @@ -50,6 +52,8 @@ pip install semble # Install with pip uv add semble # Or install with uv ``` +> Note: Claude Code and Codex CLI sub-agents cannot call MCP tools. To use Semble in sub-agents, you must add the bash integration as well. + To update Semble, see [Updating](#updating). ## Main Features From 30fd91f5ec07ce2f90a591125cbec93b2c836713 Mon Sep 17 00:00:00 2001 From: Pringled Date: Tue, 5 May 2026 11:22:11 +0200 Subject: [PATCH 07/14] Made bash clearer --- README.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index b07e215..cae4fd4 100644 --- a/README.md +++ b/README.md @@ -29,7 +29,7 @@ Semble is a code search library built for agents. It returns the exact code snip ## Quickstart -Semble can be used as an [MCP server](#mcp-server) or via [Bash / AGENTS.md](#bash-integration). Once set up, 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. +Semble can be used as an [MCP server](#mcp-server) or via [bash / AGENTS.md](#bash-integration). Once set up, 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. ### MCP @@ -43,8 +43,6 @@ Using another agent harness? See [MCP Server](#mcp-server) for setup instruction ### Bash / AGENTS.md - - Install Semble and add the [code search snippet](#bash-integration) to your `AGENTS.md` or `CLAUDE.md`: ```bash @@ -52,7 +50,7 @@ pip install semble # Install with pip uv add semble # Or install with uv ``` -> Note: Claude Code and Codex CLI sub-agents cannot call MCP tools. To use Semble in sub-agents, you must add the bash integration as well. +> Note: Claude Code and Codex CLI sub-agents cannot call MCP tools directly. To use Semble in sub-agents, you must add the bash integration as well. To update Semble, see [Updating](#updating). From 182d1319e2bdc682a37d7d2919cd9c224ff8e37e Mon Sep 17 00:00:00 2001 From: Pringled Date: Tue, 5 May 2026 11:24:31 +0200 Subject: [PATCH 08/14] Made bash clearer --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index cae4fd4..0f6a365 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ -Semble is a code search library built for agents. It returns the exact code snippets they need instantly, using ~98% fewer tokens than grep+read and cutting latency on every step. Indexing and searching a full codebase end-to-end takes under a second, with ~200x faster indexing and ~10x faster queries than a code-specialized transformer, at 99% of its retrieval quality (see [benchmarks](#benchmarks)). Everything runs on CPU with no API keys, GPU, or external services. Run it as an [MCP server](#mcp-server) and any agent (Claude Code, Cursor, Codex, OpenCode, etc.) gets instant access to any repo, cloned and indexed on demand. +Semble is a code search library built for agents. It returns the exact code snippets they need instantly, using ~98% fewer tokens than grep+read and cutting latency on every step. Indexing and searching a full codebase end-to-end takes under a second, with ~200x faster indexing and ~10x faster queries than a code-specialized transformer, at 99% of its retrieval quality (see [benchmarks](#benchmarks)). Everything runs on CPU with no API keys, GPU, or external services. Use it as an [MCP server](#mcp-server) or via [bash / AGENTS.md](#bash-integration) and any agent (Claude Code, Cursor, Codex, OpenCode, etc.) gets instant access to any repo, cloned and indexed on demand. ## Quickstart @@ -50,7 +50,7 @@ pip install semble # Install with pip uv add semble # Or install with uv ``` -> Note: Claude Code and Codex CLI sub-agents cannot call MCP tools directly. To use Semble in sub-agents, you must add the bash integration as well. +> Note: Claude Code and Codex CLI sub-agents cannot call MCP tools directly. If you need sub-agent support, use the bash integration directly, or in addition to MCP. To update Semble, see [Updating](#updating). @@ -120,7 +120,7 @@ Add to `~/.cursor/mcp.json` (or `.cursor/mcp.json` in your project): ## Bash integration -An alternative to MCP is to invoke Semble via Bash. This is the only option for sub-agents, which cannot call MCP tools directly (Claude Code and Codex CLI lazy-load MCP schemas at the top-level agent only). +An alternative to MCP is to invoke Semble via Bash. For Claude Code and Codex CLI, this is the only option for sub-agents, which cannot call MCP tools directly (both lazy-load MCP schemas at the top-level agent only). To add Bash support, append the following to your `AGENTS.md` or `CLAUDE.md`: @@ -165,7 +165,7 @@ This writes [`.claude/agents/semble-search.md`](src/semble/agents/semble-search. ## CLI -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. +Semble also ships as a standalone CLI for use outside of MCP. This is useful in scripts or anywhere you want search results without an MCP session. ```bash # Search a local repo From 1f92b2e5953db6910adb77aae8489dc5463feb63 Mon Sep 17 00:00:00 2001 From: Pringled Date: Tue, 5 May 2026 11:25:47 +0200 Subject: [PATCH 09/14] Made bash clearer --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 0f6a365..b7bf794 100644 --- a/README.md +++ b/README.md @@ -29,7 +29,7 @@ Semble is a code search library built for agents. It returns the exact code snip ## Quickstart -Semble can be used as an [MCP server](#mcp-server) or via [bash / AGENTS.md](#bash-integration). Once set up, 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. +Once set up, 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. ### MCP From 9121caeb809c8a730a15ef6ffde93bd4da09af72 Mon Sep 17 00:00:00 2001 From: Pringled Date: Tue, 5 May 2026 11:27:58 +0200 Subject: [PATCH 10/14] Made bash clearer --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index b7bf794..60ebf54 100644 --- a/README.md +++ b/README.md @@ -25,11 +25,11 @@ -Semble is a code search library built for agents. It returns the exact code snippets they need instantly, using ~98% fewer tokens than grep+read and cutting latency on every step. Indexing and searching a full codebase end-to-end takes under a second, with ~200x faster indexing and ~10x faster queries than a code-specialized transformer, at 99% of its retrieval quality (see [benchmarks](#benchmarks)). Everything runs on CPU with no API keys, GPU, or external services. Use it as an [MCP server](#mcp-server) or via [bash / AGENTS.md](#bash-integration) and any agent (Claude Code, Cursor, Codex, OpenCode, etc.) gets instant access to any repo, cloned and indexed on demand. +Semble is a code search library built for agents. It returns the exact code snippets they need instantly, using ~98% fewer tokens than grep+read and cutting latency on every step. Indexing and searching a full codebase end-to-end takes under a second, with ~200x faster indexing and ~10x faster queries than a code-specialized transformer, at 99% of its retrieval quality (see [benchmarks](#benchmarks)). Everything runs on CPU with no API keys, GPU, or external services. Use it as an [MCP server](#mcp-server) or via [Bash / AGENTS.md](#bash-integration) and any agent (Claude Code, Cursor, Codex, OpenCode, etc.) gets instant access to any repo — querying in natural language instead of grepping through full files, and getting back only the relevant context. ## Quickstart -Once set up, 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. +Your agent will automatically use Semble whenever it needs to find code. Instead of grepping with a keyword and reading full files, it queries in natural language (e.g. `"How is authentication handled?"`) and gets back only the relevant context. Semble can be set up as an MCP server or as a bash tool: ### MCP From 4b738ab514d140124d7717d71b4d75ce9c312cec Mon Sep 17 00:00:00 2001 From: Pringled Date: Tue, 5 May 2026 11:28:54 +0200 Subject: [PATCH 11/14] Made bash clearer --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 60ebf54..015bc61 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ -Semble is a code search library built for agents. It returns the exact code snippets they need instantly, using ~98% fewer tokens than grep+read and cutting latency on every step. Indexing and searching a full codebase end-to-end takes under a second, with ~200x faster indexing and ~10x faster queries than a code-specialized transformer, at 99% of its retrieval quality (see [benchmarks](#benchmarks)). Everything runs on CPU with no API keys, GPU, or external services. Use it as an [MCP server](#mcp-server) or via [Bash / AGENTS.md](#bash-integration) and any agent (Claude Code, Cursor, Codex, OpenCode, etc.) gets instant access to any repo — querying in natural language instead of grepping through full files, and getting back only the relevant context. +Semble is a code search library built for agents. It returns the exact code snippets they need instantly, using ~98% fewer tokens than grep+read and cutting latency on every step. Indexing and searching a full codebase end-to-end takes under a second, with ~200x faster indexing and ~10x faster queries than a code-specialized transformer, at 99% of its retrieval quality (see [benchmarks](#benchmarks)). Everything runs on CPU with no API keys, GPU, or external services. Use it as an [MCP server](#mcp-server) or via [bash / AGENTS.md](#bash-integration) and any agent (Claude Code, Cursor, Codex, OpenCode, etc.) gets instant access to any repo. ## Quickstart From 91ee30ca884d15df03bc87696d99a77926843621 Mon Sep 17 00:00:00 2001 From: Pringled Date: Tue, 5 May 2026 11:32:53 +0200 Subject: [PATCH 12/14] Made bash clearer --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 015bc61..082cdc4 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ -Semble is a code search library built for agents. It returns the exact code snippets they need instantly, using ~98% fewer tokens than grep+read and cutting latency on every step. Indexing and searching a full codebase end-to-end takes under a second, with ~200x faster indexing and ~10x faster queries than a code-specialized transformer, at 99% of its retrieval quality (see [benchmarks](#benchmarks)). Everything runs on CPU with no API keys, GPU, or external services. Use it as an [MCP server](#mcp-server) or via [bash / AGENTS.md](#bash-integration) and any agent (Claude Code, Cursor, Codex, OpenCode, etc.) gets instant access to any repo. +Semble is a code search library built for agents. It returns the exact code snippets they need instantly, using ~98% fewer tokens than grep+read and cutting latency on every step. Indexing and searching a full codebase end-to-end takes under a second, with ~200x faster indexing and ~10x faster queries than a code-specialized transformer, at 99% of its retrieval quality (see [benchmarks](#benchmarks)). Everything runs on CPU with no API keys, GPU, or external services. Run it as an [MCP server](#mcp-server) or call it from bash via [AGENTS.md](#bash-integration) and any agent (Claude Code, Cursor, Codex, OpenCode, etc.) gets instant access to any repo. ## Quickstart @@ -43,14 +43,14 @@ Using another agent harness? See [MCP Server](#mcp-server) for setup instruction ### Bash / AGENTS.md -Install Semble and add the [code search snippet](#bash-integration) to your `AGENTS.md` or `CLAUDE.md`: +Install Semble first, then add the [code search snippet](#bash-integration) to your `AGENTS.md` or `CLAUDE.md`: ```bash pip install semble # Install with pip uv add semble # Or install with uv ``` -> Note: Claude Code and Codex CLI sub-agents cannot call MCP tools directly. If you need sub-agent support, use the bash integration directly, or in addition to MCP. +> Note: for Claude Code or Codex CLI sub-agents, use the [Bash integration](#bash-integration) instead of, or alongside, MCP. To update Semble, see [Updating](#updating). From fce9a1758d35269ee160ab29a851319e603aa1cb Mon Sep 17 00:00:00 2001 From: Pringled Date: Tue, 5 May 2026 11:35:31 +0200 Subject: [PATCH 13/14] Made bash clearer --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 082cdc4..5cd229a 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ -Semble is a code search library built for agents. It returns the exact code snippets they need instantly, using ~98% fewer tokens than grep+read and cutting latency on every step. Indexing and searching a full codebase end-to-end takes under a second, with ~200x faster indexing and ~10x faster queries than a code-specialized transformer, at 99% of its retrieval quality (see [benchmarks](#benchmarks)). Everything runs on CPU with no API keys, GPU, or external services. Run it as an [MCP server](#mcp-server) or call it from bash via [AGENTS.md](#bash-integration) and any agent (Claude Code, Cursor, Codex, OpenCode, etc.) gets instant access to any repo. +Semble is a code search library built for agents. It returns the exact code snippets they need instantly, using ~98% fewer tokens than grep+read and cutting latency on every step. Indexing and searching a full codebase end-to-end takes under a second, with ~200x faster indexing and ~10x faster queries than a code-specialized transformer, at 99% of its retrieval quality (see [benchmarks](#benchmarks)). Everything runs on CPU with no API keys, GPU, or external services. Run it as an [MCP server](#mcp-server) or call it from the shell via [AGENTS.md](#bash-integration) and any agent (Claude Code, Cursor, Codex, OpenCode, etc.) gets instant access to any repo. ## Quickstart From 149847dbfa07924f6b9fbc4cbbf539a4360f515b Mon Sep 17 00:00:00 2001 From: Pringled Date: Tue, 5 May 2026 11:37:48 +0200 Subject: [PATCH 14/14] Made bash clearer --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 5cd229a..f646b24 100644 --- a/README.md +++ b/README.md @@ -50,7 +50,7 @@ pip install semble # Install with pip uv add semble # Or install with uv ``` -> Note: for Claude Code or Codex CLI sub-agents, use the [Bash integration](#bash-integration) instead of, or alongside, MCP. +> Note: for Claude Code or Codex CLI sub-agents, use the [bash integration](#bash-integration) instead of, or alongside, MCP. To update Semble, see [Updating](#updating).