DeepSeek Harness agent overview

Explore DeepSeek Harness—open-source agent harness with Cordis plugins, Standard/Code/Minimal modes, and traceable session logs.

DeepSeek Harness developer preview UI showing plugin-based agent modes and session trajectory controls
Category
Programming
Subcategory
Agent Harness
Pricing
Free

What is DeepSeek Harness?

DeepSeek Harness is an open-source agent harness in developer preview that treats every capability as a Cordis plugin—models, tools, skills, sessions, sandboxes, storage, loops, scheduling, and UI. The model remains the agent's reasoning core; the harness keeps it grounded in real environments with tools, traceable session logs, and swappable runtimes. Teams use it to compose coding agents without forking the DeepSeek Harness source, via configuration and community plugins.

What DeepSeek Harness offers

Core capabilities highlighted on the official developer preview site.
  1. Everything is a plugin: Cordis mounts and unmounts plugins with dependency awareness, so you can swap models, tools, skills, sandboxes, storage, loops, scheduling, and UI pieces without rewriting the harness core.

  2. Traceable session trajectory: An append-only session log records system prompts, reasoning, tool calls and results, subagent scheduling, and context injections. Resume, fork, search, and replay operate on the same event stream.

  3. Standard coding agent mode: Standard mode ships a full toolset—file editing, shell, file and web search, skills, planning, goals, subagents, and workflows—for day-to-day agent development.

  4. Code mode orchestration: Code mode exposes tools through a Code Mode SDK so the model can combine multi-step operations in one TypeScript program instead of chaining single tool calls by hand.

  5. Minimal and Creator modes: Minimal mode keeps only persistent bash and str_replace_editor for model benchmarking. Creator mode adds runtime inspection and in-memory Cordis plugin experiments for building custom presets.

  6. Open source MIT preview: Source is available on GitHub under MIT. Core plugins and APIs may still change while DeepSeek Harness remains in developer preview.

How developers start with DeepSeek Harness

A practical path from quick start to a custom plugin composition.
  1. Launch the Web UI with npx: Install Node.js, then run `npx @deepseek-ai/dsh web` to open the DeepSeek Harness Web UI without cloning the repo first.

  2. Clone when you need full source: For local plugin work, clone https://github.com/deepseek-ai/deepseek-harness and follow the repository setup instructions.

  3. Pick a runtime mode: Use Standard for full coding-agent workflows, Code mode for TypeScript-orchestrated tool batches, Minimal for two-tool benchmarks, or Creator to inspect and recombine plugins.

  4. Compose capabilities in configuration: Select, swap, or extend plugins—models, tools, skills, sandboxes, storage, loops, scheduling, UI—through configuration rather than patching harness internals.

  5. Inspect runs in Trajectory view: Open the session log to audit what the model saw, verify tool results, then resume or fork from the same append-only stream when iterating on agent behavior.

Who DeepSeek Harness is for

Roles and teams that benefit from a plugin-first agent runtime.
  1. Agent harness developers: Build or evaluate coding agents with swappable tools, sandboxes, and loops while keeping a single Cordis-based runtime.

  2. Researchers benchmarking models: Minimal mode isolates shell and file-edit tools so you can compare model behavior in a constrained, reproducible environment.

  3. Platform and infra engineers: Experiment with sandboxes, storage, scheduling, and UI plugins without rewriting the DeepSeek Harness core for each deployment shape.

  4. Teams building custom agent presets: Creator mode supports runtime inspection and in-memory plugin trials before shipping a reusable Standard or Code mode preset.

Platform and preview notes

Facts to verify on deepseek.com/harness before you depend on a workflow.
  1. Developer preview status: DeepSeek Harness is in developer preview; Cordis plugins and public APIs continue to evolve. Treat breaking changes as expected until a stable release.

  2. License and source: Distributed as open source under MIT from github.com/deepseek-ai/deepseek-harness. Community plugins are listed separately from the core repository.

  3. Quick start package: The Web UI entrypoint is `@deepseek-ai/dsh` via `npx … web`. Node.js is required; confirm current CLI flags in official developer docs.

  4. Cordis kernel: Plugin mount/unmount and dependency wiring run through Cordis services and events so capabilities can interoperate without hard-coded glue.

  5. Page type: This route is a curated listing at /deepseek-harness. Installs, docs, and GitHub issues live on DeepSeek’s official properties.

  6. Affiliation: This page is not affiliated with DeepSeek beyond discovery and documentation. Pricing and eligibility (if any) are determined on deepseek.com.

Frequently Asked Questions

Quick answers about this tool—open a question to read more.