From c7336cc137f1545182b4ef15091bf475e087469a Mon Sep 17 00:00:00 2001 From: Pringled Date: Thu, 8 Oct 2026 18:18:14 +0200 Subject: [PATCH 1/2] fix: Use client-neutral MCP tool names in installed instructions Clients prefix MCP tool names differently (mcp__semble__search in Claude Code, semble__search in Grok and Command Code), so refer to the tools by their bare names and note that a prefix may apply. Fixes #287 --- src/semble/installer/agents.py | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/src/semble/installer/agents.py b/src/semble/installer/agents.py index 4434a9e9..822d359a 100644 --- a/src/semble/installer/agents.py +++ b/src/semble/installer/agents.py @@ -94,11 +94,11 @@ def semble_pin() -> str: {SEMBLE_START} ## Semble Code Search -A `semble` MCP server is available with two tools: -- `mcp__semble__search` — search the codebase with a natural-language or code query. -- `mcp__semble__find_related` — find code similar to a specific file and line. +A `semble` MCP server is available with two tools (your client may show them with a prefix, e.g. `mcp__semble__search` or `semble__search`): +- `search` — search the codebase with a natural-language or code query. +- `find_related` — find code similar to a specific file and line. -Use `mcp__semble__search` to find where something is implemented — instead of using Grep or Glob to discover files. After semble returns the file and line, navigate there directly and read that file. Do not grep for the same content again. +Use semble's `search` tool to find where something is implemented — instead of using Grep or Glob to discover files. After semble returns the file and line, navigate there directly and read that file. Do not grep for the same content again. Pass `content="docs"` to the MCP search tool for documentation and prose, `content="config"` for config files, or `content="all"` for everything. On the CLI, use `--content docs`, `--content config`, or `--content all` instead. @@ -116,11 +116,11 @@ def semble_pin() -> str: ### Workflow -1. Call `mcp__semble__search` with a query describing what the code does or its name. The tool returns results with 10 lines of context each (function/class signature + first body lines, enough to confirm the location). +1. Call semble's `search` tool with a query describing what the code does or its name. The tool returns results with 10 lines of context each (function/class signature + first body lines, enough to confirm the location). 2. Navigate directly to the top result's file and line. Read only the function or class at that location. 3. Make the edit. Do not re-search or grep for the same content. 4. Set the MCP search tool's `content` field to `docs`, `config`, or `all` when searching beyond code. -5. Optionally use `mcp__semble__find_related` with `file_path`, `line`, and the same `content` selection to discover similar code elsewhere. +5. Optionally use semble's `find_related` tool with `file_path`, `line`, and the same `content` selection to discover similar code elsewhere. 6. Use Grep only when you need every occurrence of a literal string across the whole repo (e.g., all callers of a renamed function). {SEMBLE_END} """ From 019e1c1186ee6eddb905a6999380e4b87fa0c1df Mon Sep 17 00:00:00 2001 From: Pringled Date: Thu, 8 Oct 2026 18:21:03 +0200 Subject: [PATCH 2/2] chore: Drop client prefix hint from installed instructions --- src/semble/installer/agents.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/semble/installer/agents.py b/src/semble/installer/agents.py index 822d359a..e2c6968f 100644 --- a/src/semble/installer/agents.py +++ b/src/semble/installer/agents.py @@ -94,7 +94,7 @@ def semble_pin() -> str: {SEMBLE_START} ## Semble Code Search -A `semble` MCP server is available with two tools (your client may show them with a prefix, e.g. `mcp__semble__search` or `semble__search`): +A `semble` MCP server is available with two tools: - `search` — search the codebase with a natural-language or code query. - `find_related` — find code similar to a specific file and line.