dsh-crew
DeepSeek Harness (DSH) plugin: dispatch work to DSH agents from Claude Code / Codex — native subagent progress, in-host worker sessions with per-tier presets, a
What is dsh-crew?
DeepSeek Harness (DSH) plugin: dispatch work to DSH agents from Claude Code / Codex — native subagent progress, in-host worker sessions with per-tier presets, and a multimodal bridge that lends the text-only harness vision and image generation.
Overview of dsh-crew
What it is
DSH Crew is a plugin for DeepSeek Harness (DSH) — an open-source agent harness. It makes DSH agents dispatchable from Claude Code, Codex, Antigravity and Grok: the orchestrator keeps its own model, the work runs on a real DSH agent with that harness's tools, sandbox, presets and session history, and the host still shows it as a native subagent with live progress.
Key features
- Native Progress UI: Workers appear as regular subagents in the host's task panel with dispatch count, running step, tool calls, token usage, and a claude-hud statusline segment.
- Tier Policy and Escalation:
flashfor mechanical work,profor reasoning,effortfromofftomax.tier_policyclamps dispatch to one tier;escalate_on_failureretries a failed flash run once on pro. - In-Host DSH Sessions: Each worker is a first-class DSH session visible in the Web UI, grouped by working directory, mounted with the Agent preset per tier. Without DSH running, falls back to a standalone DSH runtime.
- Vision and Image Generation:
describe_imageprefers DeepSeek's VL model (deepseek-v4-flash-vision-exp) when a key is available, then falls back to CLIs (Claude, Codex, Grok, Antigravity) or any OpenAI-compatible API.generate_imageborrows the same CLIs. - Dispatch Guardrails: Worker→worker nesting capped at depth 3, cycles refused; second worker on a held workspace refused with holder info. Refusals are readable errors.
- Jobs Board: Lists every worker job (running or finished) with tier, effort, live progress, tokens; held workspaces show holders; vanished jobs surface as orphan ghosts.
- One-Click Install: Settings page installs/updates Claude Code plugin, Codex role files, Antigravity/Grok agents, skills, commands — with backup.
Use cases
- Dispatching complex tasks from Claude Code, Codex, Antigravity or Grok to DSH agents for better tooling, sandboxing and session history.
- Running parallel translations, code generation or data processing with tiered capability (flash for simple, pro for reasoning).
- Using vision and image generation with text-only models via the multimodal bridge.
Getting started
Install into a DSH profile from npm: bash dsh plugin --profile web add @zseven-w/dsh-crew@latest dsh web For local development: bash dsh plugin --profile web add link:/path/to/dsh-crew dsh web Configure DeepSeek credentials (standalone only): obtain an API key from platform.deepseek.com and write it to ~/.config/dsh-crew/.env: DEEPSEEK_API_KEY=sk-... Verify: bash node scripts/smoke.mjs Then install host integrations via Settings → DSH Crew or command line: bash node src/install/cli.mjs all
License and pricing
License: MIT. Open source.
Based on the project's public README and repository metadata.