reviewzy

revisión mcp con intervención humana para texto orientado al usuario: los agentes registran, un humano aprueba, las sesiones posteriores aplican

auditoría masiva y reescritura de textos orientados al usuario en CLIs, TUIs, interfaces web y sitios web; la autoría de la prosa sigue siendo humana

reviewzy es un panel de control autoalojado y un servidor mcp para la revisión de textos con intervención humana. un agente de codificación registra las cadenas exactas que quiere escribir o reescribir. un humano redacta o aprueba cada una en el panel. una sesión de agente posterior obtiene las palabras aprobadas y las aplica en su lugar. sin claves i18n, sin capa de contenido: cada entrada apunta a la cadena donde ya vive.

registra una entrada:

{
  "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"
}

la llamada responde con la entrada como draft y un enlace al panel para el lote:

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

Por qué

• registro + anclas de fragmento, sin claves i18n: la aplicación inversa es un reemplazo selectivo en el lugar

• los humanos redactan, los agentes aplican: la máquina de estados está impuesta por el servidor; solo el panel llega a approved o rejected

• guía de estilo por proyecto como recurso mcp: combinada con la guía global, incrustada en fetch_approved

• historial de revisiones de solo añadidura: cada guardado es deshacible; el historial sobrevive al archivado

• notificaciones ntfy y webhook, retención de archivo: un aviso por lote de registro; las entradas aplicadas se archivan después de ARCHIVE_AFTER_DAYS

Related MCP server: approval-gate

Cómo funciona

Instalación

bunx reviewzy@latest

requiere bun >= 1.3 (el almacén es bun:sqlite, solo bun; no hay versión npx). el shim lanza un demonio compartido por máquina en el primer uso.

desde un clon del repositorio:

bun install
bun run daemon

como plugin de Claude Code

el repositorio es un plugin: registra el servidor MCP y añade un comando de barra /reviewzy además de la habilidad reviewzy.

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

el mismo requisito de bun que en la versión npm.

Uso

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"}

abre http://127.0.0.1:3123/ para el panel.

Configuración

copia .env.example a .env y edítalo. cada clave es opcional; un valor incorrecto impide el arranque.

una credencial que quede sin establecer mantiene esa superficie solo de bucle local (loopback) con una advertencia al arrancar.

Integraciones

apunta un cliente mcp a reviewzy para empezar a registrar:

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

el endpoint habla la revisión mcp 2026-07-28 sin estado.

Comparación

la familia mcp de intervención humana bloqueante muestra un diálogo por llamada: sin cola, sin persistencia, sin panel.

Preguntas frecuentes

¿Cómo apruebo texto generado por IA antes de que llegue a mi código? el agente registra cadenas como borradores, tú las redactas o apruebas en el panel, y el agente las aplica.

¿Puede un agente de IA reescribir el texto de ayuda de mi CLI sin claves i18n? sí. las entradas se anclan en las cadenas actuales exactas; la aplicación inversa es un reemplazo selectivo.

¿Cómo reescribo en masa todo el texto orientado al usuario en una base de código? registra lotes por proyecto, agrupa por proyecto o lote en el panel, aprueba en masa con un diff antes/después y luego deja que una sesión de agente posterior obtenga y aplique.

¿Cómo actualizo la guía de estilo que leen mis agentes? edítala en el panel en /style-guide. una edición guardada llega a los agentes en un máximo de 60 segundos.

Desarrollo

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

Licencia

AGPL-3.0. lo autoalojado sigue siendo autoalojado; un saas que lo envuelva publica sus cambios.