Saltar al contenido
claudemods

Diff: el panel diff de Claude Code con los cambios sin confirmar de tu sesión

Un panel /diff para Claude Code: cambios sin confirmar, archivo por archivo con sus hunks, siempre al día.

Permisos

  • Lee archivosPuede leer archivos y listar directorios en tu equipo ($.fs.read / list / stat / exists).
  • Ejecuta comandosPuede ejecutar programas de shell en tu equipo ($.process.run / spawn). Revisa el código fuente para ver exactamente cuáles.
  • Intercepta llamadas a herramientasVe cada llamada a herramienta que hace Claude (tool.call / tool.check) y podría bloquearla o modificarla.
  • Lee tus promptsPuede ver lo que escribes y la transcripción de la conversación (prompt.* / session.append / session.messages).
  • Modifica la interfazDibuja en la interfaz de Claude Code: bandas, paneles, texto de estado, avisos (ui.render / $.ui.*).
  • Añade comandos/herramientasRegistra nuevos comandos de barra o herramientas invocables por ti o por Claude ($.command.register / $.tool.register).
  • Guarda datosConserva datos entre sesiones en el almacén privado del plugin ($.store.*).
probado con
v2.1.310
última prueba
requiere
Claude Code ≥ 2.1.287
superficies
panel
código fuente
Anthropic (anthropics)

Instalar dentro de Claude Code:

git clone https://github.com/anthropics/claude-code
claude --plugin-dir ./claude-code/mods/diff
Todas las opciones de instalación ↓

¿Qué hace este mod?

Diff es un mod que Anthropic publica en el repositorio claude-code y que listamos aquí como mod de la comunidad. Es un panel diff de Claude Code: /diff abre los cambios sin confirmar de la sesión junto a la transcripción, con una fila por archivo modificado y los hunks de cada archivo debajo; otro /diff lo cierra. Cada cambio deja Diff panel shown o Diff panel hidden en la transcripción.

El panel se actualiza después de que Claude edita un archivo o ejecuta un comando de shell, y mientras está abierto vigila el HEAD del repositorio, de modo que un commit o checkout hecho en otro sitio también aparece. Puede comparar el árbol de trabajo con el HEAD del inicio de la sesión (por defecto), con el HEAD sin más, o con el merge-base de la rama por defecto, y un selector puede mostrar en su lugar las ediciones de un turno anterior. Los archivos que ya habían cambiado antes de la sesión, además de lockfiles, archivos generados y tests, se listan aparte y plegados.

Si el terminal es lo bastante ancho, la primera edición correcta de una sesión abre el panel por sí sola. Sin el diseño de pantalla completa, /diff abre en cambio un diálogo en línea: una lista de archivos con cinco filas alrededor de la seleccionada, Enter muestra solo los hunks de ese archivo y Escape vuelve atrás. El botón [ ask ] de un archivo lo arma, de modo que sus hunks viajan una vez con el siguiente prompt como contexto.

Demo

La grabación inicia Claude Code con el mod cargado en el pequeño proyecto de demostración, que tiene un cambio sin confirmar. Escribe /diff y el autocompletado muestra «Toggle the diff panel showing uncommitted changes». Tras Enter, sobre el prompt se abre un diálogo con borde titulado Uncommitted changes (git diff HEAD), con 1 file changed +2 debajo. Lista src/index.js con un botón [ ask ] y, debajo, el hunk con números de línea y las dos líneas añadidas resaltadas en verde. El pie dice ↑/↓ to scroll · Esc to back. El clip permanece unos segundos en el diálogo. Muestra la forma en línea porque el terminal de la demo no usa el diseño acoplado.

Instalación

Usa cualquiera de los métodos del bloque de instalación; instalan directamente desde el repositorio propio del autor. Tras el siguiente inicio de sesión, escribe /diff dentro de un repositorio git con un archivo modificado.

$ install diff

Requiere Claude Code ≥ 2.1.287

Se instala desde el marketplace del autor: anthropics/claude-code

  1. 1.Pruébalo sin instalarlo

    git clone https://github.com/anthropics/claude-code
    claude --plugin-dir ./claude-code/mods/diff

    Carga el mod solo para una sesión. No se añade nada a tu configuración.

Cómo funciona

El módulo hooks/register.ts registra /diff en session.start, dibuja el componente Pane y escucha tool.call de Edit, Write, NotebookEdit, Bash y PowerShell para saber cuándo refrescar. Cada proceso hijo de git recibe el directorio git y el árbol de trabajo fijados del repositorio, y todo diff empieza con los mismos argumentos fijos, de hooks/git/argv/diff-leading-args.ts:

export const DIFF_LEADING_ARGS = [
  '--no-optional-locks',
  '-c',
  'diff.relative=false',
  '-c',
  'core.quotePath=false',
  'diff',
  '--no-ext-diff',
  '--no-textconv',
  '--ignore-submodules=dirty',
  '--submodule=short',
] as const

Git se ejecuta solo en los momentos en que lo ejecutaría el panel integrado: no al iniciar la sesión, una vez para encontrar el repositorio cuando /diff o la primera edición lo necesitan, y después en las lecturas tras una edición o un comando de shell. La salida tiene un tope, y a partir de 500 archivos solo se muestran totales. Si en la sesión ya hay otro comando /diff registrado, el mod se aparta.

Personalízalo

El mod no tiene opciones en /config. La base de comparación se elige en el panel y ctrl+x b pasa a la siguiente; la elección se guarda por repositorio en el propio almacén del plugin. La lista se desplaza con ctrl+up/ctrl+down y opt+up/opt+down. Si no quieres que el panel se abra en la primera edición, ciérralo una vez y el mod lo recuerda. Definir CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING también detiene la apertura automática.

Permisos y seguridad

Leímos el manifiesto, hooks/hooks.json y hooks/register.ts, y buscamos en los cerca de 800 archivos restantes de hooks/ accesos a red, procesos, escritura de archivos y entorno. No leímos línea por línea el directorio de 3,4 MB, que son sobre todo pequeños módulos de TypeScript y tests. No hay package.json, script de instalación, binario ni código minificado o codificado.

  • Cambia la interfaz: el panel o el diálogo, y los toasts.
  • Añade un comando: /diff.
  • Procesos: $.process.run solo para subcomandos de git de lectura (rev-parse, status, diff, ls-files, merge-base, show-ref, symbolic-ref), con la configuración regional fijada en C.
  • Red: ninguna encontrada. Archivos: lee archivos y marcas de tiempo del repositorio con $.fs; solo escribe en $.store.
  • Entorno: lee CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING.
  • Telemetría: llama a $.telemetry.log y $.telemetry.mark, que se descartan donde falta la telemetría integrada de Claude Code; no encontramos que el mod envíe nada por sí mismo.
  • Influencia sobre el modelo: el hook prompt.submit añade los hunks de un archivo armado al contexto del prompt, solo después de que pulses el botón ask de ese archivo.
  • Licencia: LICENSE.md dice «all rights reserved», sin ID SPDX; por eso esta página enlaza y no refleja el código.

claude plugin validate no informó de errores ni advertencias, pero dejó avisos de que el README no tiene línea de instalación y falta un icono, y notas de que siete hooks no tienen .catch. Las pruebas del autor pasaron: 234 correctas, 0 fallidas en 30 archivos, con Claude Code 2.1.310.

Lee archivos
Puede leer archivos y listar directorios en tu equipo ($.fs.read / list / stat / exists).
Ejecuta comandos
Puede ejecutar programas de shell en tu equipo ($.process.run / spawn). Revisa el código fuente para ver exactamente cuáles.
Intercepta llamadas a herramientas
Ve cada llamada a herramienta que hace Claude (tool.call / tool.check) y podría bloquearla o modificarla.
Lee tus prompts
Puede ver lo que escribes y la transcripción de la conversación (prompt.* / session.append / session.messages).
Modifica la interfaz
Dibuja en la interfaz de Claude Code: bandas, paneles, texto de estado, avisos (ui.render / $.ui.*).
Añade comandos/herramientas
Registra nuevos comandos de barra o herramientas invocables por ti o por Claude ($.command.register / $.tool.register).
Guarda datos
Conserva datos entre sesiones en el almacén privado del plugin ($.store.*).

Compatibilidad y solución de problemas

Comprobado con Claude Code 2.1.310 en macOS (validate, pruebas y grabación). Si /diff no muestra nada:

  • Estás dentro de un repositorio git; fuera de uno, /diff lo dice y no hace nada más.
  • Hay un archivo realmente modificado; si no, ves No changes this session.
  • Hay otro /diff registrado: entonces el mod queda inactivo.
  • Para la apertura automática, el terminal mide al menos 144 columnas con el diseño de pantalla completa.
  • Por debajo de 110 columnas con ese diseño aparece una línea que pide un terminal más ancho.

Preguntas frecuentes

¿Diff envía mi código a algún sitio?
No encontramos código de red. Ejecuta en tu máquina solo comandos de git de lectura (rev-parse, status, diff, ls-files, merge-base, show-ref, symbolic-ref) y dibuja el resultado. Al modelo solo llegan los hunks de un archivo, y únicamente después de que pulses su botón ask.
¿Modifica mi repositorio?
No. Todos los comandos de git que encontramos son de lectura y se ejecutan con --no-optional-locks, --no-ext-diff y --no-textconv. El plugin solo escribe en su propio almacén, donde recuerda si el panel estaba abierto y qué base de comparación elegiste.
¿Por qué /diff a veces se abre solo?
Tras la primera edición correcta de una sesión, si el checkpointing de archivos está activo y el terminal es lo bastante ancho (144 columnas, o 110 si antes lo dejaste abierto). Si lo cerraste, te deja en paz. En terminales más estrechos y en el diseño en línea solo se abre con /diff.
¿Qué hace el botón ask?
Arma un archivo. Con tu siguiente prompt, el plugin añade los hunks de ese archivo como contexto una vez y lo desarma. Si los hunks no caben en el espacio de contexto, se descartan y la línea de estado lo indica.
¿Puedo redistribuirlo o hacer un fork?
Por lo que encontramos, no. El LICENSE.md del repositorio dice «All rights reserved» y remite a los Commercial Terms of Service de Anthropic, así que enlazamos el repositorio y no reflejamos el código.
Rama git sobre el prompt funcionando en Claude CodeDestacado

Rama git sobre el prompt

Tu rama git, los archivos cambiados y el estado ahead/behind en una franja de una línea sobre el prompt de Claude Code.

  • sobre el prompt
  • Ejecuta comandos
  • Intercepta llamadas a herramientas
  • Modifica la interfaz

probado con v2.1.310

cc-pr-tracker funcionando en Claude CodeDestacado

cc-pr-tracker

Una línea por PR de GitHub sobre el prompt de Claude Code: merge, revisión, checks requeridos y avisos al cambiar.

  • sobre el prompt
  • aviso
  • Lee archivos
  • Ejecuta comandos
  • Intercepta llamadas a herramientas
  • Lee tus prompts
  • Modifica la interfaz
  • Añade comandos/herramientas
  • Guarda datos

probado con v2.1.296

Blast Radius funcionando en Claude CodeDestacado

Blast Radius

Retiene rm -r, force push y migraciones de base de datos en Claude Code y muestra qué cambiarían antes de ejecutarse.

  • panel
  • sobre el prompt
  • Ejecuta comandos
  • Intercepta llamadas a herramientas
  • Modifica la interfaz

probado con v2.1.291

Más en Git y GitHub, Herramientas que añades a Claude.