dsh-semble: A DSH plugin for Semantic Code Retrieval in DeepSeek Harness

What Does It Do?

Semble is a DSH plugin for DeepSeek Harness that brings Semble's code index into every session as two native MCP tools. It solves the problem of knowing how code behaves but not what the file is called: grep needs a string you already remember, while this needs a sentence describing behaviour, such as where the retry policy is applied when a request fails. After installation the tools sit next to read and grep, and the agent decides when the index is worth a call.

Core Features

• Semantic search: mcp__semble__search takes a sentence describing the code or where it lives and returns ranked file:line hits with snippets.
• Related lookup: mcp__semble__find_related takes one known location and returns its neighbours — other implementations, callers, and tests.
• Multi-repo and content filters: the repo argument accepts an absolute path, an https:// git URL, or a list of repositories, while content selects code, docs, config, or all.
• Tunable results: top_k defaults to 5 and can be raised to 10–20 when the first pass misses; max_snippet_lines defaults to 10 and 0 returns locations only.
• Index reuse: the first query against a repository builds its index (slow, one-time) and later queries reuse it; a score near 0.0x usually means nothing relevant is there.
• Slash command: /semble exposes the two reporting subcommands MCP does not cover, /semble savings and /semble file-types.

How to Use This Plugin?

Once enabled in DSH, ask the agent where a piece of logic lives; it calls search for candidate locations, opens them with read, and answers from the source instead of guessing file names. The repo argument is required and accepts a repository path or git URL; raise top_k to widen the search, and set content to all to index docs and config too. The plugin requires uv on PATH because uvx launches Semble, and the first start downloads the package and embedding model (about 1–2 minutes, one-time, offline afterwards); restart DSH once after installing. The semble-mcp row in Settings lets you adjust args and env, for example HF_ENDPOINT on restricted networks or SEMBLE_CACHE_LOCATION to move the index. The plugin is maintained by CodeIntegrity under the MIT license.

How to Troubleshoot This Plugin?

After installation the settings row may read as pending restart; restarting DSH once resolves it. If the first query seems to hang, the package and embedding model are still downloading, so let it finish. When a restricted network blocks the model download, configure a mirror endpoint in the environment settings and retry.