dsh-advisor: A DSH plugin that provides passive review and advice injection for DeepSeek Harness

dsh-advisor is an Advisor plugin (DSH plugin) for DeepSeek Harness (DSH), maintained by omdsh-dev, licensed under MIT, and developed in TypeScript. It ports the omp advisor subsystem, equipping each session with an independent reviewer model that passively observes the primary transcript, reviews each stepped turn using an explicitly configured provider and model, and injects severity-ranked advice (nit / concern / blocker) back into the session without polluting or recursively reviewing itself. The advisor is advisory only—it never approves or rejects the primary agent's actions, nor issues commands as if it were the primary agent. End-to-end guards (emission guard, immuneTurns cooldown, failure policy) ensure a misbehaving reviewer can never stall or pollute the primary loop. It works in both dsh front ends: the web profile (Settings → Plugin Configuration → Advisor card) and the dsh-tui terminal profile (/advisor and /advisor config).

What core features does the dsh-advisor DSH plugin support?

Key features include a per-session independent reviewer model, step-by-step review with explicitly configured provider and model, severity-ranked advice injection (nit / concern / blocker), and end-to-end safety mechanisms (emission guard, immuneTurns cooldown, failure policy). It is disabled by default; when enabled, provider and model are mandatory—enabling without both is a hard gate that prevents any model call and reports a disabled-with-reason status. Configuration keys compose across three surfaces: plugin-row config (cordis.patch.yml), the dsh web Settings Advisor card, and the dsh-tui /advisor config command, with later layers overriding earlier ones, and each surface shares the same hard gate.

How to install dsh-advisor?

Installing dsh-advisor is straightforward using the dsh plugin command, supporting both web and dsh-tui front ends by switching the --profile flag. You can pin a version (e.g., [email protected]) or install from registry, git, tarball, or local directory. The installation command is:

dsh plugin --profile web add github:omdsh-dev/dsh-advisor

For the dsh-tui terminal front end, use:

dsh plugin --profile dsh-tui add dsh-advisor

How to configure dsh-advisor?

Add an advisor section to the global dsh settings document (default $DSH_HOME/settings.yaml). Configuration keys include enabled, provider, model, systemPrompt, immuneTurns, and maxDeltaMessages. provider and model are required when enabled. Example configuration:

advisor:
  enabled: true
  provider: deepseek-official
  model: deepseek-v4-flash
  systemPrompt: ""
  immuneTurns: 3
  maxDeltaMessages: 60

Which DeepSeek Harness versions and platforms are compatible with dsh-advisor?

The plugin is compatible with both the web and dsh-tui front ends of DeepSeek Harness, requiring Node.js ^22.19 or >=24. It depends on @deepseek-ai/dsh-* packages, resolved via the dsh installation's flat profile module fallback, with no extra install step. The plugin is maintained by omdsh-dev, last updated in 2026-08, and licensed under MIT.

View more DSH plugins at dsh-plugin.org