Introduction

DSH’s extension mechanism is plugin-oriented: different capabilities can be installed according to profiles rather than being written entirely into the main program. For the DSH Web profile, if handling the external provider’s OAuth login entry on a page is needed, @edge-sky/dsh-oauth-adapter is a targeted component.

Below is an introduction to its positioning, installation method, and applicable boundaries. First, it is important to note that it provides the OAuth account page and provider login entry, but does not handle credential management or maintain login state.

What is this

@edge-sky/dsh-oauth-adapter is a DSH plugin maintained by edge-sky under the MIT license.

It provides an OAuth account page for the DSH Web profile and exposes the provider login flow already existing in pi-ai via the DSH Authorization Service. Since DSH currently does not mount the ctx.authorization service, this plugin mounts the service manually.

Core Features

The plugin supports OAuth login paths for the following providers:

  1. OpenAI Codex: browser callback or device code.
  2. GitHub Copilot: GitHub or GitHub Enterprise device code.
  3. Anthropic: browser callback, and supports manual code/redirect fallback.
  4. Kimi For Coding: device code.
  5. OpenRouter: browser PKCE callback.
  6. xAI: device code.

It should be noted that the plugin itself does not manage OAuth credentials or maintain login state. It solves the problem of providing an actionable OAuth login account page within the DSH Web profile.

Installation and Enablement

First, install it to the DSH Web profile:

dsh plugin --profile web add @edge-sky/dsh-oauth-adapter

If you do not have the dsh command installed directly, you can also use:

npx @deepseek-ai/dsh plugin --profile web add @edge-sky/dsh-oauth-adapter

After installation, start DSH Web:

npx @deepseek-ai/dsh web

Typical Usage

  1. Execute the installation command to install @edge-sky/dsh-oauth-adapter to the web profile.
  2. Run npx @deepseek-ai/dsh web to start DSH.
  3. Select the provider requiring login on the OAuth account page of the DSH Web profile.
  4. Complete the browser callback, device code, or manual code/redirect fallback according to the login path supported by the provider.

After the steps above, you can use the OAuth account page provided by this plugin in the Web profile.

Use Cases and Notes

Suitable for developers using the DSH Web profile who wish to expose the provider login entry of pi-ai into the page.

Please pay attention to the following before use:

  1. This plugin only provides the OAuth account page and login flow entry; it does not save credentials or maintain login state.
  2. The documentation states that it has only been tested on DSH 0.1.1-rc.2; before upgrading the DSH version, compatibility checks should be performed first.
  3. As a DSH plugin, it runs with the permissions of the current dsh process. You should check the source code before installation and confirm that the MIT license meets internal requirements.
  4. The DSH Community Directory is an independent site and not an official app store.

Links

  • GitHub: https://github.com/edge-sky/dsh-oauth-adapter
  • Directory Page: Please check @edge-sky/dsh-oauth-adapter in the DSH Community Directory site.