DSH Plugins Marketplace

DSH Plugins

Plugins

/

reviewd

A

reviewd

Discovered

Agent-native code review control plane: independent AI pre-review, inline human comments and fix-loop feedback for DSH, Claude Code, Codex and pi.

reviewd

An agent-native code review control plane.

Independent AI pre-review, line-anchored human comments, round tracking, and a clean feedback loop back to the coding agent that opened the review.

CI License: MIT Node npm

Quick start · npm packages · Features · Documentation · Agents

reviewd review detail: re-anchored comments, suggestions and fix status after a round

A real review after a fix round: one thread addressed, three decisions still open, and every comment still attached to its line.

See it in motion

reviewd walkthrough: review queue, comment thread, diff, reviewer report and submit dialog

Open the 13-second WebM walkthrough · the flow from queue to handoff, recorded on the real UI.

Why reviewd

Coding agents are good at opening a change and bad at closing the loop around it. reviewd gives the change a durable review surface:

  • an independent reviewer can inspect the diff before a human does;
  • a human can leave precise, line-anchored comments and accept or dismiss findings;
  • the next agent pass gets deterministic markdown/JSON feedback instead of a chat summary;
  • every round, decision and resolution stays in an audit-friendly event log.

reviewd is self-hosted and harness-agnostic. DSH gets a native panel and tools; Claude Code, Codex, pi and a plain shell use the same authenticated CLI/HTTP contract. It is not a GitHub/GitLab replacement — it is the review layer for agent-driven work.

npm packages

The public packages are published on npm under the @sir_yami scope:

PackageLatestInstallRole
@sir_yami/reviewdnpmdsh plugin --profile web add @sir_yami/reviewdDSH bundle
@sir_yami/reviewd-servernpmnpm install -g @sir_yami/reviewd-serverdaemon, API and review CLI
@sir_yami/reviewd-corenpmnpm install @sir_yami/reviewd-coreTypeScript library

These are layers, not three alternatives. Install the one that matches where the review should live.

What should I install?

SituationInstall
Review inside DSH, with no separate service@sir_yami/reviewd
DSH panel backed by a shared daemon@sir_yami/reviewd-server on the daemon host and @sir_yami/reviewd in DSH with embedded: false
Standalone browser UIDocker Compose, which includes the web build; the npm server package is API/CLI-first
CLI or HTTP API for agents, CI and remote machines@sir_yami/reviewd-server
Custom TypeScript adapter, or embedding review state in another process@sir_yami/reviewd-core

What each package contains

@sir_yami/reviewd — DSH integration. Start here if you use DeepSeek Harness. The bundle brings the sidebar panel, the review_* tools, a reviewer worker, feedback delivery and its own SPA at /code-review. It starts the daemon in-process, so there is no separate reviewd process to install or supervise. The bundle already contains the server and core code it needs; installing those separately adds nothing.

@sir_yami/reviewd-server — standalone service and CLI. Use it when the review service must outlive DSH, be shared by several agents or machines, or be called from scripts. It provides the reviewd daemon, the authenticated HTTP/SSE API, worker leases, deliveries and the review CLI. It depends on @sir_yami/reviewd-core, so a single npm install brings the library with it.

The npm server tarball ships the daemon and CLI, not the built browser SPA. The API and review CLI work without it. For the standalone UI use the Docker Compose stack, point CODE_REVIEW_WEB_DIR at a built packages/web/dist, or use the DSH bundle's panel.

@sir_yami/reviewd-core — TypeScript library. Use it only when you are writing an adapter, a custom service or tests that need review state directly. It exposes the store, lifecycle, snapshots, diff anchoring, reviewer contracts and feedback types. It has no review binary, HTTP server, SPA or worker process.

Do not install all three "to be safe". DSH users need only @sir_yami/reviewd; standalone services and agents need only @sir_yami/reviewd-server; custom integrations need @sir_yami/reviewd-core in addition to their own runtime.

A tour of the review loop

1. One queue for every change

reviewd review queue grouped by repository with status and not-fixed counts

Reviews are grouped by repository and show status, rounds, open comments and the count that still needs attention. Search and filters work on the same list a human actually uses.

2. The diff is the workspace

reviewd unified diff with file tree, changed files and finding badges

Delta and full views, a file tree with change counts, inline suggestions and comment or finding badges. Every thread keeps its file, side and line — including lines outside the hunk.

3. An independent pre-review

reviewd reviewer report with severity, findings, dismissed decision and fix status

A reviewer worker posts structured findings with severity, evidence, questions and optional suggestions. A human accepts or dismisses each one with a note; accepted work stays actionable for the next agent.

4. Submit is a handoff, not a comment

reviewd submit review dialog with verdict, summary and pending comments

Submitting produces a deterministic feedback package: unresolved comments, accepted findings, dismissed reasons, suggestions, questions and verification. Resolved comments are included only when selected. It is delivered to the initiating DSH session or read by CLI/HTTP clients.

reviewd review detail reflowed for a narrow viewport

The same review surface down to 320px, with keyboard navigation and light/dark themes.

The same review survives a force-push: comments are re-anchored across renames and moved hunks, old and new locations are visible, and outcomes are explicit (applied, addressed, unchanged, outdated, moved). Nothing is silently rewritten.

What stays true

  • Independent pre-review. A read-only reviewer reads the diff, manifest and surrounding code, then posts findings as events — never as an unstructured chat log.
  • Review that survives the change. Immutable rounds, quoted context, content hashes and deterministic re-anchoring keep the conversation attached to the code.
  • A real handoff. The feedback package has a stable key and no timestamps or random values, so repeated reads and deliveries are idempotent.
  • Self-hosted state. Append-only events.jsonl per review, local store, one token, no hosted service. The UI, CLI, DSH bundle and workers are adapters over the same service.

Quick start

Docker (recommended)

Requires Docker 26+ with Compose v2. The stack binds 127.0.0.1:3100 by default.

TOKEN="$(openssl rand -hex 32)"
CODE_REVIEW_TOKEN="$TOKEN" CODE_REVIEW_PUBLIC_URL=http://127.0.0.1:3100 \
  docker compose up -d --build
docker compose ps
curl -fsS http://127.0.0.1:3100/api/health

Open http://127.0.0.1:3100, sign in with $TOKEN, and create a review. Keep the token across restarts by copying .env.example to .env; .env is gitignored.

The image only sees repositories you mount. See Deploy reviewd for repository mounts, TLS, token rotation, backups, retention and upgrades. Do not expose port 3100 directly to the public internet: there is one shared token and no account system.

Local (Node 22)

pnpm install
pnpm build
export CODE_REVIEW_TOKEN="$(openssl rand -hex 32)"
export CODE_REVIEW_STORE=/tmp/code-review-store
node packages/server/dist/reviewd.js
# http://127.0.0.1:3100

Need a disposable repository and a ready-made review? Run scripts/demo.sh; it starts a daemon on a random port, creates a base..feature review and prints the URL.

DSH

dsh plugin --profile web add @sir_yami/reviewd

Restart the profile so Host routes and loops load. Embedded mode is the default: the bundle starts reviewd in-process and serves the review UI at /code-review behind DSH session auth. See DSH integration for configuration, tools, worker and data retention.

Release status: the 0.4.0 npm release is live under @sir_yami: DSH bundle, core, server and CLI. Docker and source checkouts remain available.

CLI

Install the published CLI:

npm install -g @sir_yami/reviewd-server
review version

The package exposes review and reviewd. From a source checkout, build and run node packages/server/dist/cli.js.

review start --repo /srv/repo --base main --reviewer worker --json
review status <id> --json
review comments add <id> --file src/a.ts --line 42 --body 'Please explain'
review feedback <id> --wait --format md
review submit <id> --request-changes --summary 'Address the blocker'
review refresh <id>
review health

Remote commands use CODE_REVIEW_URL (or --daemon) and CODE_REVIEW_TOKEN. review diff is local and needs no daemon. See the CLI reference for the full command surface and exit codes.

Documentation

I want to…Start here
See the full feature tourFeatures
Install and create my first reviewQuick start
Review a change as a humanReview a change
Run a fix agent against review feedbackRun a fix agent
Connect DSH, Claude Code, Codex, pi or HTTPConnect an agent
Deploy and operate reviewdDeploy
Look up commands or HTTP routesCLI · HTTP API
Understand the internalsArchitecture · Review state
Work on the codeCONTRIBUTING.md

The complete documentation index is docs/README.md. Agents that use reviewd should start at AGENTS.md; a machine-readable index is at llms.txt.

How it works

flowchart LR
  Agent[Coding agent] -->|start review| Daemon[reviewd]
  Daemon --> Reviewer[Independent reviewer]
  Reviewer -->|findings| Daemon
  Daemon --> UI[Human review UI]
  UI -->|comments, decisions, submit| Daemon
  Daemon -->|deterministic feedback| Agent
  Agent -->|fix, refresh, resolve| Daemon

The daemon owns the review lifecycle; the UI, CLI, DSH bundle and workers are adapters over the same service. See Architecture for components and data flow.

Security model

  • One shared bearer token (CODE_REVIEW_TOKEN, 32+ bytes), required at startup and never logged or baked into the image. Browsers exchange it for an HttpOnly, SameSite=Strict cookie; machine clients use Authorization: Bearer.
  • Health and version are public; all review data is authenticated. Mutations reject cross-origin requests; there is no CORS. Rate limits and body/diff/snapshot caps bound resource use.
  • reviewd is plain HTTP. Terminate TLS at a reverse proxy and keep the listener on loopback or a private network. There are no per-user accounts or token revocation lists.
  • Reviewer output and comments are untrusted data. Rendering is safe text/code; reviewer tools use a read-only allowlist; command backends run without a shell, with a minimal environment and bounded output.

See SECURITY.md for the full threat model and reporting process.

Status and limitations

  • 0.4.0 release. API/schema version 1; no automatic event-schema migrations.
  • Single-tenant by design: one token, no accounts, no hosted control plane.
  • No bundled model or agent CLI; bring a DSH worker, command backend or your own reviewer.
  • Native adapters exist for DSH only. Claude Code, Codex, pi and other harnesses use the CLI/HTTP contract; MCP is not shipped.
  • The event store is a single-writer local filesystem store; there is no HA/clustering.
  • The image is Linux/amd64-oriented; multi-arch manifests are not published.
  • npm packages are published under @sir_yami/*: DSH bundle, core, server and CLI 0.4.0.

License

MIT

Comments

Loading…

Similar plugins

dsh-code-review

by acanzaima

以Deepseek Harness、Codex为代表的Agent形态接管了自然语言需求到代码的翻译,dsh-code-review则是为了将开发者人工review这一环节从古法工具中搬进Deepseek Harness,补齐完全AI Agent Coding的最后一环。如果你对要提交的AI Coding产出还不够放心,同时你还在使用古法编程时代的ide或git可视化工具来查看代码变更,那么或许ds

Manifest valid

★ 4

JavaScript

Nov 17, 2026

dsh plugin --profile web add @acanzaima/dsh-code-review

Runs a diff past several reviewers at once — a CLI coding agent such as codex or claude, or a DSH subagent — and merges their separate sections into one report; reviewers and named review modes are co

Development & InfrastructureManifest valid

★ 1

MIT

JavaScript

dsh plugin --profile web add dsh-review

by hezhongtang

Headless Claude Code consultations with advisor, reviewer, and designer roles, returned as reference answers.

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 0

↓ 89/wk

MIT

JavaScript

Aug 19, 2026

dsh plugin --profile web add dsh-capability-optimizer

by oriliz

给 AI 编程助手一根马鞭:本地 trace 记录时间去向,每轮收尾把复盘写回 agent 指令/技能/工具,改没改好用数据说话——你看得见、控得住的自进化闭环。Evidence-backed, auditable self-improving loop for AI coding agents. DSH / Claude Code / Codex.

Development & InfrastructureManifest valid

★ 19

↓ 671/wk

MIT

Python

Nov 18, 2026

dsh plugin --profile web add agent-crop-dsh

by MichengAI

DSH Code Review — 为 DeepSeek Harness 提供 Codex 风格代码审查、原生独立子 Agent、灵活范围选择和中英文报告 · Codex-style code review with native independent agents, flexible scope selection, and bilingual reports for DSH

Development & InfrastructureManifest valid

★ 17

↓ 5.4k/wk

Apache-2.0

JavaScript

Nov 14, 2026

dsh plugin --profile web add @michengai/dsh-code-review

by JasonFreeLab

Registers a /code-review slash command with five parallel review lenses and per-finding confidence scoring, for both pull requests and local code.

Development & InfrastructureManifest valid

★ 2

↓ 192/wk

MIT

JavaScript

Oct 19, 2026

dsh plugin --profile web add dsh-command-code-review