reviewzy

Human-in-the-Loop-mcp-Review für nutzerorientierte Texte: Agenten reichen ein, ein Mensch genehmigt, spätere Sitzungen wenden an

Massenprüfung und Neuschreibung von nutzerorientierten Texten für CLIs, TUIs, Web-UIs und Websites; die Autorenschaft der Prosa bleibt menschlich

reviewzy ist ein selbst gehostetes Dashboard und ein mcp-Server für das Human-in-the-Loop-Review von Nutzertexten. Ein Codierungsagent reicht die genauen Zeichenketten ein, die er schreiben oder neu schreiben möchte. Ein Mensch verfasst oder genehmigt jede einzelne auf dem Dashboard. Eine spätere Agentensitzung ruft die genehmigten Wörter ab und wendet sie direkt an. Keine i18n-Schlüssel, keine Content-Schicht: Jeder Eintrag zeigt auf die Zeichenkette, an der sie bereits lebt.

Einen Eintrag einreichen:

{
  "project": "my-app",
  "entries": [
    {
      "repo": "https://github.com/me/my-app",
      "file": "src/cli/main.ts",
      "anchor_text": "error: something went wrong",
      "agent_draft": "error: could not reach the reviewzy daemon",
      "file_content": "#!/usr/bin/env bun\nconsole.error(\"error: something went wrong\")\n",
      "constraints": { "max_len": 48, "tone": "plain, lowercase" }
    }
  ],
  "filed_by": "help-text-audit"
}

Der Aufruf antwortet mit dem Eintrag als draft und einem Dashboard-Link für den Batch:

{
  "batch_id": "01M060XY9GNK6ANVENN4Y4MK7N",
  "results": [
    { "id": "01M060XY9GNK6ANVENN4Y4MK7P", "status": "draft", "deduped": false, "updated": false }
  ],
  "dashboard_url": "http://127.0.0.1:3123/?project=my-app"
}

Warum

• Einreichen + Snippet-Anker, keine i18n-Schlüssel: Rückanwendung ist ein gezieltes Ersetzen an Ort und Stelle

• Menschen verfassen, Agenten wenden an: Die Statusmaschine wird serverseitig erzwungen; nur das Dashboard erreicht approved oder rejected

• Projektbezogener Styleguide als mcp-Ressource: zusammengeführt mit dem globalen Leitfaden, eingebettet in fetch_approved

• append-only-Revisionshistorie: Jedes Speichern ist rückgängig machbar; die Historie übersteht das Archivieren

• ntfy- und Webhook-Benachrichtigungen, Aufbewahrung im Archiv: ein Ping pro Einreichungs-Batch; angewendete Einträge werden nach ARCHIVE_AFTER_DAYS archiviert

Related MCP server: approval-gate

So funktioniert es

Installation

bunx reviewzy@latest

erfordert bun >= 1.3 (der Speicher ist bun:sqlite, nur bun; keine npx-Form). Der Shim startet einen gemeinsamen Daemon pro Maschine bei der ersten Verwendung.

aus einem Checkout:

bun install
bun run daemon

als Plugin für Claude Code

Das Repo ist ein Plugin: Es registriert den MCP-Server und fügt einen /reviewzy-Slash-Befehl sowie den reviewzy-Skill hinzu.

/plugin marketplace add uwuclxdy/reviewzy
/plugin install reviewzy@reviewzy

Die gleiche bun-Anforderung wie bei der npm-Form.

Verwendung

curl http://127.0.0.1:3123/health

{"name":"reviewzy","version":"0.1.0","pid":4172598,"nonce":"881f0e93-8dde-4c75-b559-d2e3d3b223f0","startedAt":"2026-08-16T19:31:28.640Z"}

Öffne http://127.0.0.1:3123/ für das Dashboard.

Konfiguration

Kopiere .env.example in .env und bearbeite es. Jeder Schlüssel ist optional; ein ungültiger Wert verweigert den Start.

Eine nicht gesetzte Anmeldeinformation hält diese Oberfläche nur über Loopback erreichbar, mit einer Startwarnung.

Integrationen

Richte einen mcp-Client auf reviewzy aus, um mit dem Einreichen zu beginnen:

{
  "mcpServers": {
    "reviewzy": {
      "command": "bunx",
      "args": ["reviewzy@latest"]
    }
  }
}

Der Endpunkt spricht die zustandslose 2026-07-28-mcp-Revision.

Vergleich

Die blockierende Human-in-the-Loop-mcp-Familie öffnet pro Aufruf einen Dialog: keine Warteschlange, keine Persistenz, kein Dashboard.

FAQ

Wie genehmige ich KI-generierten Text, bevor er in meinen Code gelangt? Der Agent reicht Zeichenketten als Entwürfe ein, du verfasst oder genehmigst sie auf dem Dashboard, der Agent wendet sie an.

Kann ein KI-Agent meinen CLI-Hilfetext ohne i18n-Schlüssel neu schreiben? Ja. Einträge verankern sich an den exakten aktuellen Zeichenketten; das Zurückanwenden ist ein gezieltes Ersetzen.

Wie schreibe ich alle nutzerorientierten Texte in einer Codebasis massenhaft neu? Reiche Batches pro Projekt ein, gruppiere nach Projekt oder Batch auf dem Dashboard, genehmige massenhaft mit einem Vorher/Nachher-Diff und lass dann eine spätere Agentensitzung abrufen und anwenden.

Wie aktualisiere ich den Styleguide, den meine Agenten lesen? Bearbeite ihn auf dem Dashboard unter /style-guide. Eine gespeicherte Bearbeitung erreicht Agenten innerhalb von bis zu 60 Sekunden.

Entwicklung

bun run check  # tsc --noEmit && bun test

Lizenz

AGPL-3.0. Selbst gehostet bleibt selbst gehostet; eine SaaS, die es umschließt, veröffentlicht ihre Änderungen.