Back to directory

dockyard-dsh

Curated pickMaintenance: Active

aitabby/dockyard-dsh

A macOS-only native account-pool and provider plugin for DeepSeek Harness.

View on GitHub
$ npx -y @dockyard-dsh/install@latest

78

stars

8

forks

JavaScript

Language

MIT

License

2026-08-15

Created

2026-09-30

Last push

MIT-licensed, macOS-first native dsh bundle/plugin that merges Codex, Antigravity, Grok, Claude, and Cursor accounts into a single account pool with live model catalogs and quota views. Currently a developer preview (v0.1.1) with a one-command installer and a self-contained universal DMG.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-28

License

MIT

01What can it help you accomplish?

  • Manage Codex, Antigravity, Grok, Claude, and Cursor accounts as a unified pool inside DeepSeek Harness

    A shared account pool, live model catalog, quota view, and provider-native request path, operated through DSH's `/dockyard` command surface — no second proxy gateway

    DeepSeek Harness (dsh) users on macOS who run multiple official provider accounts and want native browser-OAuth onboarding, local-session scanning, and account-pool policies

  • Run a self-contained Dockyard setup without manually installing Node.js, pnpm, or DSH

    A macOS universal DMG that embeds Node.js, the DSH CLI, the complete `web` profile, and the Dockyard plugin — double-click to launch

    macOS users who prefer a standalone app over manual CLI/plugin setup

02How to install into DeepSeek Harness

Prerequisites

  • Node.js available — required for the one-command installer `npx -y @dockyard-dsh/install@latest` (or use the self-contained DMG to skip Node.js, pnpm, and DSH entirely)
  • DSH CLI (`dsh`) and pnpm — the README says to install the DSH CLI first and verify that the `dsh` command is available when installing the source plugin into an existing profile; the current bundle is verified against `@deepseek-ai/dsh@0.1.1-rc.2`
  • macOS — the released build is a macOS-only developer preview (Windows EXE is built but not yet uploaded/verified)

Installation steps

  1. 01

    One-command install: run `npx -y @dockyard-dsh/install@latest` in a terminal (or hand it to an agent) — it checks for DSH and pnpm, then installs the prebuilt Dockyard host/client bundle into the default `web` profile; restart DSH Web afterwards.

    $ npx -y @dockyard-dsh/install@latest

  2. 02

    Or install the source plugin into the built-in `web` profile: `dsh plugin --profile web add github:AITabby/dockyard-dsh`, then run `dsh web` (do not create an empty custom profile if you want the GUI). For a reproducible install, pin a verified commit: `dsh plugin --profile web add github:AITabby/dockyard-dsh#<commit-sha>`.

    $ dsh plugin --profile web add github:AITabby/dockyard-dsh

  3. 03

    Or skip manual setup entirely: download the self-contained universal DMG for macOS, which embeds Node.js, the DSH CLI, the complete `web` profile, and the Dockyard plugin — double-click to run.

Verify the integration

  • Inspect the composed configuration with `dsh web --dump-config` (the default URL is `http://127.0.0.1:3080`).
  • Inside DSH, run `/dockyard status` (and `/dockyard models <provider>`) to check live account and model state.

03DSH integration and capability boundaries

DSH integrationNative runtime

Native DSH bundle/plugin installed via the official `dsh plugin` command (e.g. `dsh plugin --profile web add github:AITabby/dockyard-dsh`); runs a shared Dockyard runtime — DSH bundle, LLM adapter, commands, and client UI — inside the DSH web profile

  • Unified account pool & provider-native request path

    accounts and sessions from official OAuth / official clients (Codex, Antigravity, Grok, Claude, Cursor)→one shared account pool, model catalog, quota view, and provider-native request path inside DeepSeek Harness

  • /dockyard command surface

    commands such as status, scan, add, login, refresh, models, policy, use, remove→provider and account management from inside a running DSH profile

  • Official browser OAuth onboarding with CLI fallback

    each provider's official browser authorization page, opened from “login/add account”→a securely imported completed session in the account pool, with CLI fallback retained for compatibility

    browser OAuth refresh tokens persist in secure credential storage; macOS uses Keychain by default
  • Account-pool selection policies

    manual, sticky-session, round-robin, or failover policy selection→account selection per policy

  • Live provider metadata

    live provider responses→model catalogs, reasoning tiers, plans, and quota windows

    missing values remain `unknown`/`null`
  • Scan existing local login states

    existing official desktop / CLI session state on the local machine→discovered accounts that can be added without re-authentication

    scan and adding a new account are separate operations; an existing account is never silently re-imported by Add

04Who is it for? When not to use it?

Good for

  • DeepSeek Harness (dsh) users on macOS who run multiple official provider accounts and want native browser-OAuth onboarding, local-session scanning, and account-pool policies
  • macOS users who prefer a standalone app over manual CLI/plugin setup

Not for

  • The released build is a macOS-only developer preview with a local ad-hoc signature; the macOS integration depends on native behavior (Keychain + Swift helper, DSH GUI opening browser OAuth). Some provider CLI scan/compatibility fallbacks still require their provider CLI, and Antigravity browser OAuth still requires the official OAuth client configuration.
  • Antigravity browser OAuth requires the `DOCKYARD_ANTIGRAVITY_CLIENT_ID` and `DOCKYARD_ANTIGRAVITY_CLIENT_SECRET` environment variables — the repository does not embed OAuth credentials. Without them, use an existing local/CLI session through Scan or the CLI fallback.
  • The Windows EXE is built but is still being uploaded and verified; do not use it for production until the release asset is available and verified.

05Compatibility, maintenance and safety notes

  • The released build is a macOS-only developer preview with a local ad-hoc signature; the macOS integration depends on native behavior (Keychain + Swift helper, DSH GUI opening browser OAuth). Some provider CLI scan/compatibility fallbacks still require their provider CLI, and Antigravity browser OAuth still requires the official OAuth client configuration.
  • Antigravity browser OAuth requires the `DOCKYARD_ANTIGRAVITY_CLIENT_ID` and `DOCKYARD_ANTIGRAVITY_CLIENT_SECRET` environment variables — the repository does not embed OAuth credentials. Without them, use an existing local/CLI session through Scan or the CLI fallback.
  • DeepSeek Harness is still a developer preview and may introduce breaking changes; the current bundle is verified against `@deepseek-ai/dsh@0.1.1-rc.2`. Back up an existing DSH_HOME and verify with an isolated DSH_HOME before upgrading it.
  • The Windows EXE is built but is still being uploaded and verified; do not use it for production until the release asset is available and verified.
2026-08-152026-08-17v0.1.1

MIT · developer preview (latest release v0.1.1, 2026-08-17)

06Frequently asked questions

How do I install Dockyard DSH into DeepSeek Harness?

If Node.js is already available, run the one-command installer `npx -y @dockyard-dsh/install@latest` — it checks for DSH and pnpm, then installs the prebuilt Dockyard host/client bundle into the default `web` profile; restart DSH Web afterwards. Or add the source plugin directly with `dsh plugin --profile web add github:AITabby/dockyard-dsh` and then run `dsh web`.

Does it need a second proxy gateway?

No. Dockyard DSH is a native DSH bundle/plugin — the README states it "does not require a second proxy gateway and it does not put provider-specific branches into the DSH core". It installs through the official `dsh plugin` command, not as a separate gateway.

Which providers are supported?

Codex, Antigravity, Grok, Claude, and Cursor — each with official browser OAuth, CLI fallback, and a native request transport. When an official client, CLI, or OAuth source is missing or not signed in, Dockyard reports an explicit unavailable/degraded state rather than inventing accounts, models, versions, plans, or quota values.

How do I add or import an account?

For a new account, use `/dockyard login <provider>` to open the provider's official browser OAuth. To import an existing local session, use `/dockyard scan <provider>` followed by `/dockyard add <provider>`, then inspect `/dockyard status` and `/dockyard models <provider>`.

Which platforms are supported?

macOS is the released platform — a self-contained universal DMG is available and the macOS integration depends on native behavior (Keychain, DSH GUI opening browser OAuth). The Windows EXE is built but still being uploaded and verified; the README says do not use it for production until the release asset is available and verified. Note that Antigravity browser OAuth requires `DOCKYARD_ANTIGRAVITY_CLIENT_ID` and `DOCKYARD_ANTIGRAVITY_CLIENT_SECRET`.

08Data and sources

  • Author-claimedgithub.com7af23286c2a4…

    **A native account-pool and provider plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`ds…

  • Author-claimedgithub.com7af23286c2a4…

    Dockyard DSH is a DSH plugin, not a standalone agent.

  • Author-claimedgithub.com7af23286c2a4…

    It does not require a second proxy gateway and it does not put provider-specific branches into the DSH core.

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-28. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.