dsh-prospector

dsh-prospector

English | 中文

GitHub research ("prospecting") assistant for DeepSeek Harness — gives the agent model-facing tools to search repositories, read READMEs and source files, list file trees, and clone candidates, then synthesize an implementation plan from the best open-source solutions it finds.

Scenarios

• Before building something new — prospect open source first: what exists, what each candidate contributes, and what still needs building.
• Technology selection — compare candidates on activity, structure, and adoptability.
• Deep due diligence — clone and read core source for integration, license, and maintenance risk.

Tools

The agent combines these (search → read README/source → clone → read deeply); the plugin only supplies the eyes.

Commands

/research [low|medium|high] <idea>

Research an idea end to end and propose a plan. The optional leading tier (default medium) sets search breadth and read depth. Each idea gets its own subfolder under the workspace.

/gh-login

Report the GitHub authentication state and show login steps when unauthenticated.

Depth tiers

Installation

Mount it in the composition; the shipped cordis.patch.yml inserts it automatically when installed as a bundle:

- name: 'dsh-prospector'
  config:
    client: 'rest'               # 'rest' (default) or 'gh'
    ghPath: 'gh'                 # absolute path if gh is not on PATH
    workspaceRoot: '~/dsh-prospector'  # optional; default is ~/dsh-prospector

Mount it beside a subprocess provider and the filesystem tools.

Authentication

The plugin never stores a token. Read operations resolve a token from GH_TOKEN/GITHUB_TOKEN, else gh auth token. Run gh auth login once (device flow → github.com/login/device), or set GH_TOKEN.

Workspace

Clones live under a dedicated workspace root (~/dsh-prospector by default), one subfolder per research topic:

~/dsh-prospector/
  <topic-slug>/          # one folder per /research idea
    <owner>__<repo>/     # shallow clones

The workspace root and each topic folder are created automatically on first use.

Configuration

Notes & cautions

• gh and git are required — gh for auth/token, git for cloning.
• GitHub rate limits — the Search API allows ~30 requests/minute authenticated; broad/deep research is bounded by it.
• Read-only apart from clones — the plugin never mutates the model request or session surface; only clones write to the workspace.
• Re-cloning into the same folder fails — reuse a topic folder only after removing the previous clone.
• No settings panel / tier-picker UI yet — configuration is via cordis.yml; the interactive tier selector and settings card depend on DSH's client-bundle tooling for external plugins.

License

MIT