Revisión Universal de Cambios

Local, read-only Git change review for Codex, Claude Code, Cursor, and any MCP-compatible client. Version 0.4 adds one-click Changes entry points: a Cursor activity-bar extension and an MCP Apps launcher card for compatible Codex/ChatGPT hosts.

It provides total workspace diffs, staged/unstaged views, file-level inspection, and task-scoped snapshots that isolate only the changes made after a task begins. Source files and the real Git index are never modified by the review tools.

Requisitos

• Node.js 20+

• Git 2.30+

• Un repositorio Git

Herramientas

El servidor MCP también expone dos indicaciones reutilizables cuando el cliente admite indicaciones MCP:

Las capturas instantáneas de tarea utilizan un índice Git temporal y almacenan solo un id de árbol Git más metadatos en .git/universal-change-review/. Los archivos ignorados no se capturan. No se sube ningún código fuente.

Codex

Clone el repositorio, registre su marketplace, luego instale el plugin:

git clone https://github.com/IP-DZ/universal-change-review.git
codex plugin marketplace add ./universal-change-review
codex plugin install universal-change-review@ip-dz

El paquete de Codex incluye la habilidad change-review, metadatos de UI, indicaciones iniciales, la definición del servidor MCP y una tarjeta de lanzador de MCP Apps. Invoque la habilidad explícitamente con $change-review, o pida a Codex que abra los Cambios actuales. Los hosts compatibles muestran una tarjeta Abrir Cambios en la que se puede hacer clic; otros hosts reciben la misma URL de localhost como texto.

Claude Code

Instale desde el repositorio como un plugin de Claude Code para obtener su habilidad y el comando /review-changes, o añada el servidor MCP directamente:

claude mcp add universal-change-review --scope user -- npx -y github:IP-DZ/universal-change-review mcp

Cursor

Para la experiencia más cercana al estilo DSH, instale la extensión de Cursor incluida:

npm run build:cursor
cursor --install-extension dist/universal-change-review-cursor-0.4.0.vsix --force

Después de recargar Cursor, haga clic en Revisión de Cambios en la barra de estado inferior, o use el icono de la barra de actividades Revisión de Cambios. La extensión sigue automáticamente el primer espacio de trabajo abierto y abre el panel en vivo en una pestaña del editor de Cursor. Ejecuta el mismo código de panel local y de solo lectura incluido dentro de la extensión.

Para una configuración con ámbito de proyecto, copie .cursor/mcp.json, .cursor/rules/change-review.mdc y .cursor/commands/review-changes.md en un proyecto. Luego use /review-changes en el chat de Cursor.

Para una configuración global de MCP, fusione este servidor en ~/.cursor/mcp.json sin reemplazar las entradas existentes:

{
  "mcpServers": {
    "universal-change-review": {
      "command": "npx",
      "args": ["-y", "github:IP-DZ/universal-change-review", "mcp"]
    }
  }
}

La configuración global de MCP de Cursor hace que las herramientas estén disponibles en todos los repositorios. Las reglas de Cursor y los comandos personalizados tienen ámbito de proyecto, así que copie la regla y el comando proporcionados en los repositorios donde desee el flujo de trabajo guiado.

Flujo de trabajo recomendado

1. Antes de una tarea sustancial, pida al agente que inicie una línea base de cambios.

2. Implemente y valide el comportamiento solicitado.

3. Ejecute $change-review, /review-changes o la indicación MCP review-changes según el cliente.

4. Revise los hallazgos ordenados por gravedad P0-P3, seguidos del comportamiento cambiado, validación y riesgos restantes.

Panel de Cambios en vivo

Pida al agente que “abra Cambios”, llame a la herramienta MCP changes_open_panel o ejecute:

npx -y github:IP-DZ/universal-change-review web --cwd /path/to/repo

La página de localhost devuelta proporciona recuentos de archivos en vivo, filtros Todos/Preparados/No preparados, selección de línea base de tarea y diferencias por archivo a nivel de línea. Se vincula solo a 127.0.0.1, utiliza un token de acceso aleatorio y no expone ningún punto final de escritura o reversión.

CLI

Ejecute directamente desde GitHub:

npx -y github:IP-DZ/universal-change-review summary --cwd /path/to/repo
npx -y github:IP-DZ/universal-change-review begin --cwd /path/to/repo --label feature
npx -y github:IP-DZ/universal-change-review since --cwd /path/to/repo --id SNAPSHOT_ID

Seguridad

• No se expone ninguna herramienta de deshacer, restablecer, checkout, commit, push o escritura de archivos.

• El árbol de trabajo y el índice real de Git no se modifican.

• La captura de instantáneas escribe objetos blob/árbol normales de Git y metadatos dentro de .git.

• La salida de diff está limitada por defecto y se puede restringir a un archivo.

• Los clientes aún deben solicitar la aprobación del usuario antes de lanzar servidores MCP de terceros.

Desarrollo

npm test
npm run check
npm run build:cursor

MIT © IP-DZ