MIT-licensed method pack for trustworthy AI coding agents, installable into DeepSeek Harness (dsh) as a profile plugin via `dsh plugin add github:GanyuanRan/Aegis`.
DSH integration
Compatible
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-21
License
MIT
01What can it help you accomplish?
Make AI coding agent runs in DeepSeek Harness safer and less prone to rework
The agent plans against the project's real baseline before editing and completion claims ship with fresh verification evidence, covered scope and residual risk — on the project's frozen A/B benchmark, contract pass rate went 61.67% → 93.33% and unsafe outcomes 13.33% → 0%
Developers running coding agents (DeepSeek Harness, Codex, Claude Code, OpenCode, Kimi) who want fewer reworks and safer changes on non-trivial tasks
Apply one discipline across every AI coding host you use, including DeepSeek Harness
The same method pack installed on Codex, Claude Code, OpenCode, Kimi, DeepSeek Harness and other skill-aware hosts, with host-aware updates via `scripts/aegis-update.py`
Teams standardizing agent workflows across multiple coding-agent hosts
02How to install into DeepSeek Harness
Prerequisites
- DeepSeek Harness (`dsh`) installed and a profile selected — installation is a profile-plugin install via `dsh plugin --profile <profile> add github:GanyuanRan/Aegis`
- Python available to run the verification scripts (`scripts/aegis-doctor.py`) from the installed method-pack root
Installation steps
- 01
Give the README's quick-install prompt to your agent: read the Aegis repo, identify the host (DeepSeek Harness / dsh), and install via `dsh plugin --profile <profile> add github:GanyuanRan/Aegis` instead of silently substituting the direct-child compatibility path
$ dsh plugin --profile <profile> add github:GanyuanRan/Aegis
- 02
Restart or reload the host if needed
- 03
Locate the installed `<aegis-method-pack-root>`, then run `cd <aegis-method-pack-root> && python scripts/aegis-doctor.py --write-config --json` — not from the target project directory
- 04
If the host uses a separate skill discovery directory, verify it with `--discovery-root <path>`; if the host guide declares a skill directory name prefix, also pass `--discovery-name-prefix <prefix>`
- 05
Complete the DeepSeek Harness host guide's native activation and automatic-entry checks (file discovery or a generic doctor result alone is not sufficient when the host provides a plugin, hook, or session-start bootstrap contract)
Verify the integration
- Treat the install as complete only if the doctor JSON includes `"ok": true`, `"workspaceSupport": "available"`, and `"configStatus": "configured"`
03DSH integration and capability boundaries
Installed into DeepSeek Harness (dsh) as a profile plugin via `dsh plugin --profile <profile> add github:GanyuanRan/Aegis`, with a dedicated DeepSeek Harness host guide
Baseline-first planning
coding tasks in any supported host, including DeepSeek Harness→the agent aligns with the project's real baseline — owners, contracts, boundaries — before touching code
lazily creates CONTEXT.md / CONTEXT-MAP.md files on the first resolved domain term (glossary-only)Evidence-based completion verification
completion claims from the agent→fresh verification evidence, covered scope and residual risk attached to every "done" — you read evidence, not vibes
Install & activation management (doctor / update)
the installed method-pack root→`scripts/aegis-doctor.py` reports install status and switches activation mode (`auto`/`explicit`) and TDD mode (`off`/`auto`); `scripts/aegis-update.py` performs host-scoped updates
doctor runs with `--write-config` during install verification; the host must be restarted after changing activation modeExplicit workflow triggers
natural language or explicit requests in the host session→`Aegis goal: ...` frames scope, success evidence and boundaries; `Grill me ...` starts a decision interview; `TDD Route: strict` / `test-first` requests strict test-first work; `aegis:first-principles-review` pressure-tests a direction
04Who is it for? When not to use it?
Good for
- Developers running coding agents (DeepSeek Harness, Codex, Claude Code, OpenCode, Kimi) who want fewer reworks and safer changes on non-trivial tasks
- Teams standardizing agent workflows across multiple coding-agent hosts
Not for
- For DeepSeek Harness an install guide exists, but release-level fresh host smoke is still pending — the integration is documented, not yet verified per release.
05Compatibility, maintenance and safety notes
- Aegis is the runtime-ready Method Pack, not the full Aegis Platform, a daemon, a background runner, a runtime core, or final completion authority; user instructions and target-project rules outrank Aegis guidance.
- For DeepSeek Harness an install guide exists, but release-level fresh host smoke is still pending — the integration is documented, not yet verified per release.
- The benchmark numbers are bounded advisory evidence from a frozen held-out A/B benchmark, not a universal-quality or completion-authority claim.
MIT · actively maintained (latest release v2.8.4, 2026-08-19)
06Frequently asked questions
How does Aegis integrate with DeepSeek Harness — native or MCP?
Not MCP-based: for the official DeepSeek Harness (`dsh`), global/minimal installation is a profile-plugin install with `dsh plugin --profile <profile> add github:GanyuanRan/Aegis`, following the dedicated DeepSeek Harness host guide. The direct-child compatibility path is only a fallback if the plugin manager is unavailable and you explicitly approve it.
How do I verify the installation succeeded?
From the installed method-pack root (not your project directory), run `python scripts/aegis-doctor.py --write-config --json`. The install counts as complete only when the JSON includes `"ok": true`, `"workspaceSupport": "available"`, and `"configStatus": "configured"`, plus the host guide's native activation and automatic-entry checks.
What prerequisites do I need?
DeepSeek Harness (`dsh`) with a profile to install into, and Python to run the doctor/update scripts. No separate API key or account is required by Aegis itself.
What are the limits? Is Aegis an authority over my project?
Aegis is the runtime-ready Method Pack — not the full platform, a daemon, or final completion authority. User instructions and target-project rules outrank Aegis guidance, and benchmark numbers are bounded advisory evidence. For DeepSeek Harness, release-level fresh host smoke is still pending.
How do I update or change modes later?
Say `update Aegis` or `aegis:update` to run the host-scoped update path (`scripts/aegis-update.py`). Activation mode defaults to automatic; switch with `python scripts/aegis-doctor.py activation-mode explicit` and restart the host. TDD is off by default.
07Related DSH workflows
distilly
by titanwings
Meta-skill turning source material into a versioned Person Profile skill with incremental merge, correction layer, rollback, per-host install.
dsh-market
by dsh-market
插件市场 (plugin marketplace): 打开 Settings → Plugin Market 浏览/搜索/一键安装社区插件；安装源限制为 curated awesome-dsh-plugin 注册表（其余拒绝），默认禁用构建脚本（pnpm>=10 需显式开启）。
ai_animation
by unclecheng-li
Generate standalone animated HTML diagrams, presentations, notes, protocol visualizations, and UI demos from prompts.
skillcorpus
by evermind-ai
Open-source infrastructure that turns scattered SKILL.md files into curated, retrieval-ready agent-skill corpora—with retrieval and evaluation tooling included.
08Data and sources
If the host is the official DeepSeek Harness (`dsh`), treat global/minimal installation as native profile-plugin install…
`DeepSeek Harness` | Install guides exist; release-level fresh host smoke is still pending | [DeepSeek Harness](docs/REA…
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-21. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.