What Is dsh-plugin-subscriptions? Subscription LLM Providers

dsh-plugin-subscriptions is a subscription LLM provider plugin for DeepSeek Harness (DSH): it turns your ChatGPT (Codex), Claude, Grok (X Premium), and GitHub Copilot subscriptions directly into model sources, eliminating the hassle of requesting and managing API keys. Based on the official README, this article covers what it does, its core features, installation, typical usage, and common troubleshooting.

What Is dsh-plugin-subscriptions?

dsh-plugin-subscriptions solves the pain of applying for a separate API key for every model service: your already-paid subscriptions become DSH model sources, via OAuth login or imported credentials. The facts below come from the official README (source):

dsh-plugin-subscriptions (GitHub repo V1ki/dsh-plugin-subscriptions) is maintained by v1ki, written in TypeScript, MIT-licensed, and is a tool-type plugin (kind tool, npm package dsh-plugin-subscriptions) in the DSH Plugin ecosystem. It supports four subscription types: ChatGPT (Codex), Claude, Grok (X Premium), and GitHub Copilot. After login, live catalogs of these subscription models appear in the DSH Web UI session model picker, along with subscription usage monitoring and extra search and image generation tools (source).

What Are the Core Features of dsh-plugin-subscriptions?

dsh-plugin-subscriptions centers on "subscription account access + live model catalog + usage and extra tools": log in once, and your subscriptions become usable model sources. Feature facts come from the official README and detail page (source):

• Subscription login: in Settings → Subscriptions of the Web UI, log in to Codex, Grok, and Copilot via OAuth; Claude auto-imports existing Claude Code credentials (macOS Keychain or ~/.claude/.credentials.json), no Claude Code CLI needed.
• Live model catalog: after login, the session model picker lists each provider's live models (e.g., Codex from chatgpt.com/backend-api/codex/models, Grok from api.x.ai/v1/models), refreshing automatically on login/logout.
• Reasoning effort and speed control: models with reasoning tiers (e.g., Codex, Grok 4.6/4.5) expose an Effort selector; Codex models support Standard/Fast speed switching (service_tier: priority), also settable via the /fast command.
• Subscription usage monitoring: login cards show each provider's usage percentage, progress bar, and reset time (Codex from wham/usage, Claude from api.anthropic.com/api/oauth/usage, Grok from cli-chat-proxy.grok.com/v1/billing); Copilot shows none as it has no usage endpoint.
• Extra tools: enabling the matching provider registers x_search (Grok's X search returning answers and citations), image_generate (gpt-image-2 via the Codex backend), and video_generate (inline video playback).

How to Install and Enable dsh-plugin-subscriptions?

dsh-plugin-subscriptions installs via the standard DSH Plugin command; restart the web client, then log in to your subscriptions under Settings → Subscriptions. Installation matches any other DSH plugin, per the official README (source):

1. Confirm your environment and target profile. dsh-plugin-subscriptions is a DSH tool plugin; install it into the profile that runs the Web UI. The examples use web as the profile name — swap in your own.

2. Run the official install command. From a DSH environment:

dsh plugin --profile web add dsh-plugin-subscriptions

Or from the GitHub source:

dsh plugin --profile web add github:v1ki/dsh-plugin-subscriptions

3. Restart the web client. After installing, restart Web for the plugin to load. Then find the Subscriptions entry in the Web UI sidebar or settings.

4. Verify and manage the plugin. Confirm dsh-plugin-subscriptions is listed:

dsh plugin list

To update, run update on the package; to remove, use remove:

dsh plugin update dsh-plugin-subscriptions

Remove the plugin with:

dsh plugin remove dsh-plugin-subscriptions

All add/update/remove operations go through standard DSH Plugin commands — no manual config editing.

Typical dsh-plugin-subscriptions Usage

Once installed and your subscriptions are logged in, daily use is "pick a model, tune effort, watch usage": subscriptions are models, one login keeps working. The following usage is based on the official README and detail page (source):

1. Log in to each subscription provider. Go to Settings → Subscriptions in the Web UI and click login per provider: Codex and Grok use OAuth, Claude imports existing Claude Code credentials first (falling back to browser OAuth), and Copilot uses the device-code flow — enter the displayed code at github.com/login/device to authorize.

2. Pick a subscription model in the model picker. After login, the session model picker lists live models from logged-in providers; select one to start chatting. The list refreshes on login/logout, with no manual model-name config.

3. Adjust reasoning effort and speed. For models with reasoning tiers (e.g., Codex, Grok 4.6/4.5), choose effort in the Effort selector next to the model picker; for Codex models, switch Standard/Fast in the Speed control (service_tier: priority) or type /fast in the conversation:

/fast

4. Use usage monitoring and extra tools. Check each provider's usage percentage, progress bar, and reset time on the Subscriptions login cards; once the matching provider is enabled, call x_search, image_generate, and video_generate to run search and image tasks, e.g. by describing the image in the conversation:

Generate a cover image about a DSH workflow

dsh-plugin-subscriptions Troubleshooting

dsh-plugin-subscriptions issues usually fall into "not showing after login", "credential import", and "/fast tiers" — most are solved with the steps below. Troubleshooting notes come from the official FAQ (source):

1. Symptom: some providers missing from the model picker after login. Fix: only logged-in providers appear, and the list refreshes on login/logout. Confirm the provider is logged in under Settings → Subscriptions; if it still doesn't show, log in again or refresh the page.

2. Symptom: Claude login reports credentials not found. Fix: Claude imports existing Claude Code credentials from macOS Keychain or ~/.claude/.credentials.json, with no CLI needed; if not found it falls back to browser OAuth. Make sure the credentials file exists and is valid, or just use OAuth login.

3. Symptom: /fast errors saying the current model has no fast tier. Fix: /fast only works on Codex models that advertise a fast tier in the catalog; otherwise it errors with an explanation. Switch to a fast-capable Codex model, or toggle Standard/Fast in the Speed control next to the model selector.

Use Cases and Notes

dsh-plugin-subscriptions suits heavy users who already pay for ChatGPT, Claude, Grok, or Copilot and want to use those models in DSH without API keys — but it depends on third-party subscription availability and login state. Notes from the official README (source):

• Good for: users with paid ChatGPT Plus/Pro, Claude Pro/Max, X Premium, or GitHub Copilot; teams that don't want to request API keys per service; daily heavy users who want usage visibility.
• Not for: scenarios with no such subscriptions that still expect pay-as-you-go billing; networks that cannot reach the subscription services' login pages; organizations with strict control over credential storage paths.
• Note: tokens live in ~/.dsh/plugins/subscriptions/auth.json (mode 0600) and refresh automatically; Copilot has no public usage endpoint, so its card showing no usage is normal; using third-party subscriptions must respect the relevant terms of service.

Project Links

dsh-plugin-subscriptions is an MIT-licensed open-source project maintained by v1ki. Plugin page: dsh-plugin-subscriptions plugin details.

This page is an independent guide rewritten from the plugin's official README — for authoritative documentation and the latest changes, refer to the source: V1ki/dsh-plugin-subscriptions. Plugins are third-party code that runs on your machine after installation; listing here is not an endorsement — review the source before installing.