Preface¶
The philosophy of DSH is “everything is a plugin,” where capabilities can be added as plugins. The community directory is an independent site with no official affiliation with DeepSeek/InsightFace, and should not be interpreted as an official app store.
For developers using DSH, a specific requirement is: having an existing GitHub Copilot subscription and wanting to put the models from that subscription into DSH’s model selector for chatting and reasoning, without needing to install Copilot CLI separately or have Copilot’s tools execute locally.
Below is an introduction to dsh-copilot-sdk. It bridges the GitHub Copilot subscription to DeepSeek Harness, registers a copilot provider, and retains the upstream @github/copilot-sdk SDK library, documentation, samples, and test suite.
What is it¶
dsh-copilot-sdk is a DSH plugin maintained by GongYuanCaiJi. It is a DSH port of @github/copilot-sdk used to integrate GitHub Copilot subscriptions as a model pool into DSH.
Plugin and upstream version information is as follows:
plugin: dsh-copilot-sdk
upstream: @github/copilot-sdk
pinned version: 1.0.11
commit: 18002a81
Regarding the license, dsh-copilot-sdk is MIT, and the upstream github/copilot-sdk is also MIT.
Core Capabilities¶
The capabilities listed below are all based on verified facts.
- Registers a
copilotprovider, using the GitHub Copilot subscription as a model pool. - The following subscription models can be used in the model selector:
copilot / gpt-5copilot / claude-sonnet-4.5copilot / deepseek-r1- The SDK includes the Copilot CLI runtime, so there is no need to install the CLI separately.
- Authentication can use an existing GitHub login, token, or BYOK.
- Pure chat bridging: The bridge layer rejects requests for Copilot tool execution.
- Supports assistant text and reasoning streaming output.
- Provides the following DSH-side commands:
/copilot status/copilot models/copilot stop- The SDK library, docs, samples, and test suite are 100% ported verbatim from the upstream.
Installation and Activation¶
dsh-copilot-sdk has not been published to npm and needs to be installed from GitHub or a local directory.
If installing from GitHub, execute the following command first:
dsh plugin --profile <your-profile> add github:GongYuanCaiJi/dsh-copilot-sdk
If installing from a local directory, prepare the plugin directory first, then execute the following command:
dsh plugin --profile <your-profile> add /path/to/dsh-copilot-sdk
Restart dsh after installation. The plugin launches Copilot CLI on demand; it starts when the first model call is made or /copilot status is executed.
If the environment uses pnpm and reports an allowBuilds error during installation, it is usually because pnpm blocks the prepare build script of git installs by default. The solution is to add the precise key printed by pnpm to the allowBuilds section in the profile’s pnpm-workspace.yaml, then retry. You can write it in the following format; the specific key depends on the pnpm output:
# pnpm-workspace.yaml
allowBuilds:
- <precise key printed by pnpm>
Typical Usage¶
After installation and restart, there are two common use cases.
- Select the
copilotprovider in the model selector of a DSH session, then choose a subscription model from it. - Specify
provider: copilotand the specific model ID in the agent configuration. The specific model ID depends on the available models in your Copilot subscription; you can check them first using/copilot models.
DSH-side available commands are as follows:
/copilot status
/copilot models
/copilot stop
Note: /copilot status is used to check the connection status; /copilot models is used to list available models; /copilot stop is used to stop the Copilot CLI runtime.
If you do not have a Copilot subscription temporarily, you can also use it via BYOK by specifying your own API key in the session/agent configuration.
Suitable Scenarios and Notes¶
Suitable scenarios:
- You have an existing GitHub Copilot subscription, including free tier plans, and want to integrate subscription models into DSH.
- You want to be able to directly call models like
copilot / gpt-5,copilot / claude-sonnet-4.5,copilot / deepseek-r1within DSH. - You only need chat and reasoning output and do not need Copilot’s tool execution.
Things to note:
- Requires a GitHub Copilot subscription unless using BYOK.
- Each model call corresponds to a one-time Copilot session; each prompt counts towards Copilot usage.
- The bridge layer rejects all permission requests; Copilot only answers as a chat model and does not execute tools.
- Telemetry code is preserved verbatim, but the bridge layer does not send it by default; if you construct your own
CopilotClientand enable it, it follows the upstream behavior. - The plugin runs under the permissions of the current
dshprocess; you should check the source code, dependencies, and license before installing.
Conclusion¶
The value of dsh-copilot-sdk lies in integrating existing GitHub Copilot subscriptions into DSH as a chat model pool, while maintaining pure chat bridging and clear command entry points.
GitHub repository address:
https://github.com/GongYuanCaiJi/dsh-copilot-sdk
You can also find it in the DSH plugin directory by the plugin name dsh-copilot-sdk.