About ctx-search
ctx-search is a skill for searching indexed content without bringing raw sources back into conversation context. It helps agents query indexed material with batched, scoped searches, using the `ctx_search` MCP tool or the CLI.
Key features
- 01Search indexed content
- 02Batch related queries
- 03Scope searches by source
- 04Use specific short queries
- 05Fall back to the CLI
Use cases
- 01Find information across indexed project files
- 02Search multiple related technical topics
MCP support
Prefers the `ctx_search` MCP tool for querying indexed content; if MCP tools are unavailable, it falls back to the `context-mode search` CLI.
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ mksglu/ context-mode --skill ctx-searchAfter installing, type/ctx-searchin Claude Code to confirm it loaded.
Details
From the project READMEContext Mode Search
Search indexed content without rereading raw sources into conversation context.
Instructions
- Prefer the
ctx_searchMCP tool when it is available. - Batch all related questions in one
queriesarray. - Scope with
sourcewhen the user names a project or indexed label. - Use short, specific queries of two to four technical terms.
ctx_search({
source: "project:<name>",
queries: ["authentication middleware", "token refresh"],
limit: 5
})
- If MCP tools are unavailable, fall back to the CLI:
context-mode search "authentication middleware" --source project:<name> --limit 5
- If the index is empty, tell the user to run
/context-mode:ctx-indexorcontext-mode index <path>first.
Comments
Markdown supported