dockyard-dsh: A macOS Account-Pool and Native Provider Plugin for DeepSeek Harness

Dockyard DSH is a macOS-only account-pool and native provider plugin (DSH plugin) for DeepSeek Harness (DSH), maintained by AITabby under the MIT license, currently in developer preview. It connects multiple official OAuth or official client sessions into DSH, providing a unified account pool, model catalog, quota status, and provider-native request entry points—no separate proxy gateway needed, and no provider logic stuffed into the DSH core. Key capabilities include managing accounts and providers via the /dockyard command, clicking "Login to add account" to open the provider's official browser authorization page, scanning existing local official login states, supporting manual selection, sticky session, round-robin, and failover account pool strategies, and reading real-time model catalogs, reasoning tiers, plans, and quota windows returned by providers.

What provider modules does the Dockyard DSH plugin support?

Currently included are Codex (official browser OAuth, CLI fallback, and native Responses request chain), Antigravity (Google official browser OAuth, official local session, real-time model catalog, credits/quota, and native Gemini SSE request chain), Grok (xAI official browser OAuth, CLI fallback, real-time model catalog, official Build credits cycle, and provider-native streaming requests; quota read via official /billing?format=credits), Claude (official browser OAuth with support for manual callback URL/authorization code with state, CLI fallback, and native request adaptation), and Cursor (official browser login polling, CLI fallback, and native request adaptation). If the corresponding official client, CLI, or OAuth source is not installed or not logged in, Dockyard returns explicit unavailable/degraded status—it never fakes results with hardcoded accounts, models, versions, plans, or quotas.

How do I install Dockyard DSH into a DeepSeek Harness Web profile?

Before installing, you need the DSH CLI (Node 22.19+ on 22.x, or Node 24+) and pnpm. Then add it directly to the web profile (do not create an empty profile with only the Dockyard bundle, or the Web GUI won't start):

npm install --global @deepseek-ai/dsh
npm install --global pnpm
dsh plugin --profile web add github:AITabby/dockyard-dsh
dsh web

It defaults to http://127.0.0.1:3080; use dsh web --dump-config to inspect the combined config. To pin a version, use a verified commit (e.g., github:AITabby/dockyard-dsh#<commit-sha>). The repo ships runnable host/client bundles, so direct GitHub installs require no extra allowBuilds configuration.

What platforms and native capabilities does Dockyard DSH support?

The current release supports macOS only; Windows EXE is in active development. Full macOS functionality relies on Keychain credential storage, Swift helper, browser OAuth (PKCE, state validation, loopback/manual-code callback), and scanning official desktop or CLI session states for providers like Cursor and Antigravity. If you prefer not to manually install Node.js, pnpm, or DSH, you can download the macOS universal DMG (bundles a full runtime, double-click to run), or build it yourself on a Mac:

./apps/macos/build-dmg.sh

The DMG includes Node.js, DSH CLI, the full web profile, and the Dockyard plugin; OAuth authorization pages open in the system default browser. The current build covers both Apple Silicon and Intel architectures.

How do I install and test Dockyard DSH from source?

For local modifications, clone the repo and install:

git clone https://github.com/AITabby/dockyard-dsh.git
cd dockyard-dsh
npm install
npm test                 # optional: verify environment
npm run build            # needed if source or bundle is stale
dsh plugin --profile web add .
dsh web

To isolate testing without affecting the default DSH home, use the DSH_HOME environment variable to point to a separate directory.

See more DSH plugins at dsh-plugin.org