Guides

dsh 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 →

From 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 →

DeepSeek 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 →

How 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 →

A 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 →

A 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 →

Cordis is the plugin framework underneath DeepSeek Harness, formalized in the preprint 'A Programming Paradigm for Spatiotemporal Composability'. Temporal composability: side effects fully revert on removal. Spatial composability: dependencies are declared and reactively managed — revertible effects plus reactive coeffects, unified in one context type.

Read guide →