# DeepSeek Harness Makes Every Subsystem a Swappable Plugin

> An open-source agent harness where models, tools, sandboxes, storage, and the UI are all swappable plugins, with a full append-only session trace.

Published: 2026-08-14
URL: https://daniliants.com/insights/deepseek-harness-makes-every-subsystem-a-swappable-plugin/
Tags: deepseek, agent-architecture, open-source, observability

---

## Summary

DeepSeek released a developer preview of "DeepSeek Harness" (DSH), an open-source agent harness where every capability (models, tools, skills, sessions, sandboxes, storage, loops, scheduling, and the UI) is a swappable plugin built on the Cordis plugin framework. It ships with full session tracing and four runtime modes for different use cases, from full-toolset agents to minimal shell-only benchmarking environments.

## Key Insight

- **Plugin-everything architecture**: unlike most agent harnesses that hardcode tool, model, and storage choices, DSH treats every subsystem (model backend, tool registry, skill loading, session persistence, sandbox execution, storage layer, agent loop, scheduler, UI) as a Cordis plugin. Swap or extend any layer via config, no source changes needed.
- **Append-only session log as the source of truth**: every system prompt, reasoning step, tool call and result, subagent scheduling decision, and context injection is recorded in one event stream. Resume, fork, search, and replay all operate on that same stream. This is a stronger observability model than most harnesses, which log tool calls but not full context injection.
- **Four runtime modes solve different problems**: Standard (full toolset, general use), Code mode (the model generates code to orchestrate multi-step tool calls instead of individual tool-call turns, reducing round-trips), Minimal (just shell plus file editor, for isolating raw model capability in benchmarks), and Creator mode (inspect the live runtime and test or combine Cordis plugins in memory, meta-tooling for harness builders).
- Install is trivially low-friction: `npx @deepseek-ai/dsh web` for a hosted web UI, or full source via `git clone https://github.com/deepseek-ai/deepseek-harness`.
- Relevant reference point for anyone building a proprietary agent harness: DSH validates that a clean plugin boundary plus full event-stream tracing is becoming table stakes for serious harness tooling, not a nice-to-have.