Mod de rama git para Claude Code: rama y cambios sobre el prompt

El mod de rama git para Claude Code coloca una línea sobre el cuadro de entrada que te dice dónde estás en git: ⎇ main · 3 changed · ↑1 ↓0. Ves el nombre de la rama, cuántas rutas aparecen como cambiadas en git status y cuánto va la rama por delante y por detrás de su upstream. Cuando HEAD está desacoplado, muestra en su lugar el hash corto del commit. Fuera de un repositorio git, la línea sencillamente no aparece.

Resulta especialmente útil cuando Claude edita en tu nombre. Te das cuenta enseguida si una sesión empezó en main en lugar de en una rama de funcionalidad, y el contador de cambios sube a medida que Claude edita, así que sabes cuándo toca revisar y hacer commit. Requiere Claude Code 2.1.287 o posterior.

La grabación inicia Claude Code con el mod cargado en un pequeño proyecto de demostración. Antes del primer prompt, la franja sobre la entrada ya muestra la rama y el número de archivos cambiados. Después se pide a Claude que liste los archivos de src; la franja permanece en su sitio mientras se ejecuta el turno y se actualiza cuando el turno termina.

Usa cualquiera de los tres métodos del bloque de instalación. El método de una línea funciona dentro de una sesión en marcha; el método desde la shell necesita /reload-plugins en las sesiones que ya están abiertas.

El mod guarda el último estado de git en un átomo de $.state y lo dibuja en el punto de renderizado AbovePrompt. Estos son los hooks de hooks/register.tsx:

on('session.start', async ($, e, next) => {
  const started = await next(e)
  await refresh($)
  $.clock.every(intervalMs, () => {
    refresh($).catch(() => undefined)
  })
  return started
})

on('turn.complete', async ($, e, next) => {
  const result = await next(e)
  if (e.agentId === undefined) await refresh($)
  return result
})

on('tool.call', { tool: 'Bash' }, async ($, e, next) => {
  const ran = await next(e)
  if (mentionsGit(e.command)) await refresh($)
  return ran
}).catch(($, e, next) => next(e))

Hay tres puntos de actualización. session.start toma la primera lectura e inicia un temporizador para los cambios hechos fuera de Claude Code. turn.complete actualiza tras cada turno del bucle principal; los turnos de subagentes (con un agentId) se omiten. El hook de tool.call para Bash deja que el comando se ejecute primero con await next(e) y después actualiza solo si el comando menciona git o gh pr checkout/merge. Su .catch deja pasar la llamada, así que un fallo del mod nunca bloquea tu comando.

refresh ejecuta un único git status --porcelain=v1 -b en $.session.cwd(). Ese comando da la rama, el upstream, el estado ahead/behind y la lista de cambios, así que no hacen falta llamadas separadas a rev-parse y rev-list. Una función pura, parseStatus en hooks/git.ts, se encarga de los repositorios nuevos sin commits y del HEAD desacoplado. Si git no está instalado o tarda demasiado, la franja se oculta en lugar de mostrar datos desactualizados.

Cambia estas opciones en /config bajo el nombre del mod; el mod se recarga con los nuevos valores. El valor por defecto del temporizador se fija al principio de register, Math.max(2_000, ... 15_000), que además impone el mínimo de 2 segundos. Para cambiar el aspecto de la franja, edita los elementos Text del hook de ui.render: la rama se dibuja en bold y en cyan, y los detalles con dimColor.

Ejecuta comandos aparece porque el mod llama a $.process.run. Ejecuta exactamente dos programas: git status --porcelain=v1 -b y, solo cuando HEAD está desacoplado, git rev-parse --short HEAD. Ambos son de solo lectura, usan un array argv sin shell y tienen un tiempo límite de 10 segundos.

Intercepta llamadas a herramientas aparece porque se engancha a tool.call para Bash. Solo observa: nunca cambia ni deniega un comando, y actualiza después de que el comando haya terminado. Modifica la interfaz cubre la franja.

No lee el contenido de los archivos, no usa la red ni llama al modelo. Para desactivarlo de forma permanente, ejecuta /plugin disable cm-git-branch; para iniciar una sesión con todos los mods desactivados, usa claude --safe-mode.

Probado con Claude Code 2.1.291 en la terminal de macOS. Si la franja no aparece, comprueba lo siguiente en este orden:

• claude --version es 2.1.287 o posterior.
• La sesión se inició dentro de un repositorio git; git status en la misma carpeta debería funcionar.
• El mod está habilitado: el menú /plugin lo muestra en la pestaña Installed, con una línea "mod active".
• Si instalaste desde la shell en una sesión abierta, ejecuta /reload-plugins.
• Hay una encuesta u otro prompt abierto sobre la entrada. La franja se aparta mientras está visible y vuelve después.

En repositorios muy grandes, aumenta intervalMs para que git status se ejecute con menos frecuencia.