DeepSeek Harness is an open-source framework for building and running AI agents, organized so that its functionality is provided through plugins. Developers use it to launch agent workflows through a local web interface or from source, while the catalogue add-ons extend the harness as plugins.
Borrowing it
Nothing to install: this file belongs to deepseek-ai/deepseek-harness. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/deepseek-ai/deepseek-harness/master/AGENTS.mdgit clone --depth 1 https://github.com/deepseek-ai/deepseek-harnessWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/deepseek-ai/deepseek-harness/agents-md)<a href="https://agentmods.dev/instructions/deepseek-ai/deepseek-harness/agents-md"><img src="https://agentmods.dev/badge/instructions/deepseek-ai/deepseek-harness/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/deepseek-ai/deepseek-harness/agents-md"><img src="https://agentmods.dev/badge/instructions/deepseek-ai/deepseek-harness/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.04159 | $0.04159 |
| Opus 5.5 | $0.01664 | $0.01664 |
| Sonnet 5.5 | $0.00832 | $0.00832 |
| Haiku 4.5 | $0.00416 | $0.00416 |
Grade A, and why
deepseek-harness AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
Copies of this mod
7 near-identical copies found in the catalogue:
- deepseek-harness-plus AGENTS.md — 92% identical, 183 lines differ
- dshcode AGENTS.md — 88% identical, 147 lines differ
- DeepSeek-Harness-GUI AGENTS.md — 83% identical, 174 lines differ
- DeepSeek-Harness-GUI CLAUDE.md — 83% identical, 174 lines differ
- deepseek-harness-desktop AGENTS.md — 83% identical, 174 lines differ
- dsh-studio AGENTS.md — 83% identical, 174 lines differ
- alego AGENTS.md — 81% identical, 53 lines differ
How it starts
The opening of the file, as written. The whole thing — 186 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md
DeepSeek Harness is an all-plugin Cordis agent harness. Read docs/architecture.md before changing packages/; follow docs/AGENTS.md for documentation.
Pre-stable APIs and released Session data
Public APIs are pre-stable; update every consumer. Follow version/status and type acknowledgements. Adjacent migration may add a version-named successor but never move, overwrite, or delete committed generations; predecessors imply neither fallback nor downgrade support. SQLite uses monotonic SCHEMA_VERSION.
Acknowledge declared persistence-type changes.
Record each externally perceptible breaking change immediately in an upgrade guide.
Application launch. Only dsh profiles launch supported Node apps; package bins, demos, and public SDK argv escapes are forbidden (rule).
Repository layout
vendor/ Vendored Cordis (vendor/README.md)
packages/ @deepseek-ai/dsh-<pkg> workspaces at packages/<group>/<pkg>/
core/ agent/session API
api/ remote BFF
typert/ type graphs
llm/ model providers
shell/ command execution
subprocess/ child-process management
ssh/ SSH execution providers
terminal/ persistent terminals
ptc-runtime/ PTC execution
sandbox/ process confinement
deliverables/ turn deliverables
fs/ filesystem access
lsp/ language servers
skill/ skill loading
web/ search/fetch tools
computer-use/ computer interaction
browser-use/ browser interaction
compaction/ context compaction
context/ request context
subagent/ delegated agents
jobs/ background jobs
bundle/ profile bundles
workflow/ workflow execution
todo/ todo_write tool
plan/ logged planning
goal/ session goals
schedule/ scheduled follow-ups
preset/ agent composition
guard/ loop/tool guards
extensions/ runtime self-modification
session/ durable sessions
session-query/ browsing/search/export
attachment/ binary attachments
spill/ output spill
storage/ non-session storage
workspace/ workspace entities
feedback/ human feedback
identity/ anonymous identity
settings/ user settings
credentials/ credentials/authorization
acp/ automation-only ACP
interaction/ human interaction
boot/ application boot
sdk/ JSON-RPC SDK
host/ GUI host
client/ GUI client
mcp/ external tools
experimental/ evaluated capabilities without a product-support commitment
test-support/ test infrastructure
util/ zero-dependency utilities
python/ Python SDK/runtime (python/README.md)
native/ @deepseek-ai/node-addon-system source (native/README.md)
benchmarks/ performance gates
.agents/ Agent workflows/notes
docs/ Documentation (docs/AGENTS.md)
scripts/ gates and generators
website/ VitePress documentation projection
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday Changed · +4 lines · +185 tokens per session 1eea39325447
- 6d ago Changed · -1 lines · +71 tokens per session 4c5ad6e8f6c9
- 13d ago Changed · -2 lines · -106 tokens per session 8606e33eb5ba
- 16d ago Changed · +2 lines · +29 tokens per session 8436bf5c9449
- 23d ago Changed · +3 lines · +159 tokens per session e8fbc2b46a80
- 28d ago Changed · +4 lines · +89 tokens per session e232924a880b
- 1mo ago Changed · +20 lines · -15 tokens per session aff5a98c2763
- 1mo ago Changed · +12 tokens per session 2592e81a9caa
- 1mo ago Changed · -2 tokens per session bbe0098b2801
- 1mo ago First seen · 156 lines · 3,737 tokens per session scan A 7a4a8ae455e8
deepseek-harness AGENTS.md is an instructions file published in the GitHub repository deepseek-ai/deepseek-harness (250,433 stars, last pushed today), licensed MIT. It adds 4,159 tokens to every session, about $0.0166 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
vscode copilot-instructions.md
Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).
generative-ai-for-beginners AGENTS.md
AGENTS.md instructions for microsoft/generative-ai-for-beginners, covering agents.md, project overview, setup commands, initial repository setup and clone the repository.