Back to directory

mstar-harness

Curated pickMaintenance: Active

btspoony/mstar-harness

An omni-plugin for harness engineering workflows with multi-agents, programmatic gates and skills.

View on GitHubHomepage
$ npx @mstar-harness/cli init --target dsh

62

stars

4

forks

TypeScript

Language

MIT

License

2026-03-06

Created

2026-09-29

Last push

An MIT-licensed Agent Plugin that runs a deterministic, gate-enforced multi-agent workflow on DeepSeek Harness — installable in one `npx` command, with dsh as a best-tier host and a portable Agent Plugins v1.0.0 package.

DSH integration

Compatible

Author-claimed

Safety audit

Unaudited

Last verified

2026-09-02

License

MIT

01What can it help you accomplish?

  • Run a deterministic, spec-driven multi-agent code-delivery workflow on DeepSeek Harness — from a product brief through plan, implement, QC/QA gates, to a merge-ready PR.

    Git-branched code changes plus tracked plans (`status.json`), workflow snapshots, and a project residual register under `.mstar/`; the audit path emits prioritized, ready-to-execute improvement plans.

    Engineering teams and solo developers running DeepSeek Harness (dsh) who want enforced workflow gates and multi-agent delivery across dsh / omp / OpenCode / Cursor / Codex hosts.

  • Audit an existing codebase or run a deep pre-merge PR review inside DeepSeek Harness without editing any source.

    Read-only survey of what's worth doing (prioritized plans) or a single verdict (`ship it` / `needs fixes` / `blocked`) with every finding, optionally posted to GitHub by the review agent.

    Maintainers and reviewers on DeepSeek Harness who need an advisory, no-write pass (codebase audit or PR review at quick / default / deep strength).

02How to install into DeepSeek Harness

Prerequisites

  • DeepSeek Harness (dsh) CLI on PATH — the dsh install path runs `dsh plugin --profile web add @mstar-harness/dsh`.
  • A Node.js runtime with npx/npm — the one-command install is `npx @mstar-harness/cli init --target dsh`; the engine check installs via `npm i -g @mstar-harness/cli`.
  • An Agent Plugins v1.0.0 conformant client — the repo ships a portable `plugin.json` + `skills/` package usable by any compliant host.

Installation steps

  1. 01

    One-command install for dsh: `npx @mstar-harness/cli init --target dsh` — this runs two independent `dsh plugin --profile web add` installs (`@mstar-harness/dsh` + `dsh-llm-fallbacks`; add `--no-fallbacks` to skip the latter).

    $ npx @mstar-harness/cli init --target dsh

  2. 02

    Or install the two packages manually: `dsh plugin --profile web add @mstar-harness/dsh` then `dsh plugin --profile web add dsh-llm-fallbacks`.

    $ dsh plugin --profile web add @mstar-harness/dsh

  3. 03

    For engine gate checks, install the CLI globally: `npm i -g @mstar-harness/cli` (puts the `mstar-harness` binary / alias `mstar` on PATH); `init` auto-installs it after a successful run unless you pass `--no-global-cli`.

    $ npm i -g @mstar-harness/cli

Verify the integration

  • `npx @mstar-harness/cli doctor --target dsh` — verifies the install for the dsh target.
  • `npx @mstar-harness/cli plugin validate` — validates the portable Agent Plugins v1.0.0 manifest (`plugin.json`) and the `skills/` component.

03DSH integration and capability boundaries

DSH integrationCompatible

Installs on DeepSeek Harness (dsh) via `dsh plugin --profile web add @mstar-harness/dsh` (plus `dsh-llm-fallbacks`); the one-command `npx @mstar-harness/cli init --target dsh` also works. dsh is a first-class, best-tier host of the shared TS engine.

  • Deterministic workflow gates (TS engine)

    per-plan dispatch requests and workflow state→enforced path/status/lease/dispatch/sdd/iteration/lint gates via `@mstar-harness/engine`

  • Pluggable JSON persistence (ArtifactStore)

    coordination docs (status.json, workflow snapshots, residuals, review envelopes)→persisted artifacts through an ArtifactStore; default FsStore keeps `.mstar/` paths

    coordination docs (`status.json`, workflow snapshots, project residuals, review envelopes) persist through an `ArtifactStore`; the default `FsStore` keeps the existing `.mstar/` paths
  • Multi-agent delivery (mstar-* skills)

    a product brief / plan→role-routed multi-agent code delivery driven by `mstar-*` judgment skills (single source of truth for roles, gates, workflow)

  • Read-only audit & review (mstar-audit)

    a codebase, PR, branch, or diff→read-only prioritized improvement plans, or a PR review verdict with findings

04Who is it for? When not to use it?

Good for

  • Engineering teams and solo developers running DeepSeek Harness (dsh) who want enforced workflow gates and multi-agent delivery across dsh / omp / OpenCode / Cursor / Codex hosts.
  • Maintainers and reviewers on DeepSeek Harness who need an advisory, no-write pass (codebase audit or PR review at quick / default / deep strength).

Not for

  • The short `mstar` alias is a shared bin namespace — an unrelated third-party npm package named `mstar` claims the same command name, and globally co-installing both silently overwrites the `mstar` shim (last install wins). Use the long name `mstar-harness` on any conflict.

05Compatibility, maintenance and safety notes

  • The short `mstar` alias is a shared bin namespace — an unrelated third-party npm package named `mstar` claims the same command name, and globally co-installing both silently overwrites the `mstar` shim (last install wins). Use the long name `mstar-harness` on any conflict.
  • Process artifacts (`plans/`, `iterations/`, `status.json`, `workflows/`, `projects/`, `sdd/`, …) are gitignored; only `{HARNESS_DIR}/AGENTS.md`, `knowledge/`, and `specs/` are tracked results.
  • Without a global CLI install the harness still works and gate checks stay advisory; set `enforcement: hard` in an iteration compass to make dispatch preflights fail-fast.
2026-03-062026-09-01v3.5.1

MIT; actively maintained — latest release v3.5.1 (2026-08-28), last push 2026-09-01 (per repo metadata)

06Frequently asked questions

How do I install Morning Star on DeepSeek Harness?

Run `npx @mstar-harness/cli init --target dsh` — it executes two independent `dsh plugin --profile web add` installs (`@mstar-harness/dsh` + `dsh-llm-fallbacks`; `--no-fallbacks` skips the latter). Or add the packages manually: `dsh plugin --profile web add @mstar-harness/dsh` then `dsh plugin --profile web add dsh-llm-fallbacks`.

Is DeepSeek Harness a first-class host, or just compatible?

dsh is a first-class, best-tier host. The README rates recommended hosts as `dsh = omp ≥ OpenCode ≥ Cursor > Kimi = ZCode > Codex`, and the same TS engine + `mstar-*` skills power dsh alongside omp, OpenCode, Cursor, Kimi Code, ZCode and Codex.

Does it edit my code, or can it run read-only?

Both. The normal flow dispatches plans onto feature branches and produces merge-ready PRs, but the audit/review commands (`/codebase-audit`, `/amazing-pr-review`) are read-only and advisory — they never edit source; findings become plans you can choose to execute.

How do I verify the install worked?

Run `npx @mstar-harness/cli doctor --target dsh` to check the dsh target, and `npx @mstar-harness/cli plugin validate` to validate the portable `plugin.json` manifest and `skills/` component.

Where do workflow artifacts get stored?

Coordination docs — `status.json`, workflow snapshots, project residuals, review envelopes — persist through a pluggable `ArtifactStore`; the default `FsStore` keeps them under `.mstar/`. Process artifacts are gitignored; only `AGENTS.md`, `knowledge/`, and `specs/` are tracked.

08Data and sources

  • Author-claimedgithub.com16a5cf2873bd…

    the same engine + skills power dsh (DeepSeek Harness), omp, OpenCode, Cursor, Kimi Code, ZCode, and Codex

  • Author-claimedgithub.com16a5cf2873bd…

    or `dsh plugin --profile web add @mstar-harness/dsh`<br>+ `dsh plugin --profile web add dsh-llm-fallbacks`

  • Author-claimedgithub.com16a5cf2873bd…

    The repo ships a portable **Agent Plugins v1.0.0** manifest (`plugin.json`) at its root; `skills/` is the Agent Skills c…

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-02. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.