seek://guides
Guides
Long-form tutorials: what a harness is, what Cordis proposes, how to ship plugins.
New to the ecosystem? Walk the guided paths on Where to start. Where to start →
Beginner
Start here if DSH is new to youChoosing a DSH Surface: Web UI, Headless, SDK, ACP, and Community Clients
Sep 5, 2026dsh is one launcher that ships five profiles — web, headless, sdk, sdk-minimal, and acp — each auto-initialized on first use. This guide maps each surface to the job the CLI reference documents for it: the Web UI for daily driving, one-shot headless runs for CI, the Python SDK for embedding, ACP for editors, plus the community TUI and desktop clients on this site's map.
Read guide →
DeepSeek Harness in 5 Minutes
Aug 15, 2026From zero to your first agent session in five minutes: install Node.js, run npx @deepseek-ai/dsh web, paste a DeepSeek API key, pick a workspace, and send your first prompt. This guide follows the official path exactly, with the three gotchas that actually trip people up.
Read guide →
What is DeepSeek Harness?
Aug 14, 2026DeepSeek Harness (dsh) is DeepSeek's open-source agent framework where every capability — model access, tools, sessions, even the agent loop itself — is a plugin with no privileged core. This guide explains the harness concept, walks one turn through the system, and shows why the session log invariant 'model-visible means logged' makes the whole thing auditable.
Read guide →
Intermediate
Hands-on guides for daily useConfigure Models and Providers in DSH
Aug 28, 2026How DSH decides which model answers: the Models page stores DeepSeek keys write-only into the credential store, catalog providers inherit their endpoint and model list from the installed catalog, and custom providers wire any OpenAI-compatible gateway through a permanent Provider ID — with an image-input line and a compat block for the two request-shape differences that break most gateways.
Read guide →
DSH Profiles and the dsh plugin Command
Aug 24, 2026A field guide to DSH's bundle/profile two-noun system and the dsh plugin command that ties them together. A profile is a directory under $DSH_HOME/profiles/<name> listing bundles it stacks; dsh plugin forwards to pnpm inside the profile, so every pnpm verb works. The shipped apps are web and headless profiles, with web also reachable through the dsh web alias.
Read guide →
Plugin 101: Your First DeepSeek Harness Plugin
Aug 15, 2026A plugin is a TypeScript module exporting apply(ctx) — that's the whole contract. This guide builds one from scratch the official way: develop it live through a cordis.yml patch layer, then package it as an installable bundle with a dsh.bundle manifest, and understand why bundle and profile are two different nouns.
Read guide →