MIT-licensed, ready-to-run DeepSeek Harness distribution (TypeScript) that wraps @deepseek-ai/dsh in a GUI + TUI workspace; sessions, files, terminals and the agent assembly are shared and user-editable, with your choice of model backend.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-25
License
MIT
01What can it help you accomplish?
Run DeepSeek Harness as a workspace that works the moment you install it
A GUI + TUI surface with sessions, files, Git, a terminal, a built-in browser and diff previews, sharing one Host session
Developers and engineers who want a DeepSeek Harness setup that runs on install and can be reopened and reshaped
Switch between desktop GUI and terminal TUI without losing task state
The same Host session record, shared across GUI and TUI via @cocode-agency/host-supervisor, so work continues across clients in the same scope
Remote and keyboard-first users who SSH into machines and keep pushing tasks without a graphical environment
Swap the agent assembly (preset) itself, not just the model
Readable agent.cordis.yml presets — Standard, PTC, Minimal, Creator — that you copy and edit in the interface
Teams and contributors who want to control which tools, prompts and capabilities a session runs
02How to install into DeepSeek Harness
Prerequisites
- For the TUI: Node.js 22.19.x or later (24+ also supported); the GUI path downloads a platform installer from GitHub Releases
- A DeepSeek-compatible API key or a Cocode Nut account to pick a model backend
Installation steps
- 01
GUI: download the installer for your platform from the GitHub Releases page, launch Cocode, then choose Cocode Nut or your own DeepSeek-compatible key
- 02
TUI: install Node.js 22.19.x+, run `npm install --global @cocode-agency/tui`, then `cocode doctor` followed by `cocode` in a real terminal
$ npm install --global @cocode-agency/tui
- 03
From source: install pnpm, then `make install-gui` + `make dev gui` (or `make install-tui` + `make dev tui`)
Verify the integration
Not specified by the author
03DSH integration and capability boundaries
Ships as a DeepSeek Harness distribution: @cocode-agency/host-supervisor pins @deepseek-ai/dsh from npm and exposes it through a GUI and TUI that lease one shared Host session.
Unified `cocode` command & plugin management
Host-scope flags (--dsh-home, --profile, --runtime-channel) and subcommands→`cocode plugin list`, `cocode host status`, `cocode doctor` and other unified entry-point commands
Desktop GUI workspace (Electron)
A DeepSeek-compatible API key or Cocode Nut account→An Electron surface with sessions, files, terminals, runtime state and diff/attachment preview panels
Terminal TUI client
A real TTY and a Host scope (DSH_HOME + profile)→A keyboard-first terminal client for remote and SSH work that attaches to the same Host
Shared Host via @cocode-agency/host-supervisor
A canonical DSH_HOME + profile + Host configuration scope→A Host endpoint that GUI and TUI lease and connect to; the runtime is @deepseek-ai/dsh from npm
GUI and TUI never launch a Harness process themselves — they acquire a lease from the HostModel choice: Cocode Nut or bring-your-own-key
A Cocode Nut account or any OpenAI-compatible / DeepSeek API key→Three switchable model sources: official DeepSeek key, any OpenAI-compatible endpoint, or Cocode Nut
04Who is it for? When not to use it?
Good for
- Developers and engineers who want a DeepSeek Harness setup that runs on install and can be reopened and reshaped
- Remote and keyboard-first users who SSH into machines and keep pushing tasks without a graphical environment
- Teams and contributors who want to control which tools, prompts and capabilities a session runs
Not for
- Keep @cocode-agency/tui and @cocode-agency/host-supervisor on the same release version line; do not mix versions from different releases. GUI installers are downloaded separately from the matching GitHub Release and are not installed through npm.
- CoCode is a developer preview built on the DeepSeek Harness developer preview. It is an independent distribution, not an official DeepSeek product, and upstream compatibility may change.
05Compatibility, maintenance and safety notes
- Keep @cocode-agency/tui and @cocode-agency/host-supervisor on the same release version line; do not mix versions from different releases. GUI installers are downloaded separately from the matching GitHub Release and are not installed through npm.
- CoCode is a developer preview built on the DeepSeek Harness developer preview. It is an independent distribution, not an official DeepSeek product, and upstream compatibility may change.
- Source builds are supported on macOS, Windows and Linux; the current release scripts target macOS and Windows artifacts, and the repository does not include a hosted backend or a vendored Harness checkout.
MIT · actively maintained (latest release v1.0.2, 2026-08-25)
06Frequently asked questions
How is CoCode related to DeepSeek Harness?
CoCode is a ready-to-run distribution of DeepSeek Harness. The host-supervisor pins @deepseek-ai/dsh from npm and CoCode presents it as a GUI + TUI workspace — it is not a separate fork, but a packaged, user-editable assembly on top of Harness.
Can the GUI and TUI share the same session?
Yes. Both attach to the same Host through @cocode-agency/host-supervisor and read/write the same session record when they use the same DSH_HOME, profile and Host configuration scope. Switching clients does not reset your work in that scope.
Do I need my own DeepSeek API key?
No. On first launch CoCode asks only one thing: use Cocode Nut or your own key. Cocode Nut is CoCode's own model service (free tier available, paid tiers add DeepSeek V4 Pro/Flash) and needs no key to apply for. You can also paste an existing DeepSeek key or any OpenAI-compatible endpoint.
Can I customize what the agent does, beyond picking a model?
Yes. The agent is a plugin assembly called a preset, readable as agent.cordis.yml right in the interface. Four presets ship built in — Standard, PTC, Minimal, Creator — and you copy one to make it yours, changing which tools, prompts and capabilities a session runs.
How do I install it?
For the GUI, download the platform installer from GitHub Releases and launch it. For the TUI, install Node.js 22.19.x+, run `npm install --global @cocode-agency/tui`, then `cocode doctor` followed by `cocode` in a real terminal. From source, use pnpm + `make install-gui` / `make install-tui`.
07Related DSH workflows
open-design
by nexu-io
🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your coding agent becomes the design engine: prototypes, landing pages, dashboards, slides, images & video — real files, HTML/PDF/PPTX/MP4 export. 🤖 Claude Code / Codex / Cursor / DeepSeek Harness / OpenCode & 20+ CLIs via BYOK.
picgo
by molunerfinn
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosting services (S3, GitHub, Cloudflare R2, Imgur, Aliyun OSS...). Paste, upload, done.
dsh-desktop
by anywhere-labs
Modern desktop client for the DeepSeek Harness (dsh) plugin ecosystem. Everything is a plugin — even the desktop shell itself.
openbiliclaw
by whiteguo233
Local-first, open-source AI content discovery agent that learns your taste and proactively finds content across Bilibili, Douyin, YouTube, Reddit, X and the open web.
08Data and sources
A ready-to-run DeepSeek Harness distribution.
The runtime underneath is DeepSeek Harness, which makes an argument of its own:
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-25. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.