⚡ Ryukami Labs

🧩 Better Claude: Plugins y Mods Esenciales para Claude Code (midudev)

Se lee en 6 min

🧩 Better Claude — Plugins y Mods de Alto Rendimiento para Claude Code

Mejora de Experiencia de Usuario y Productividad en Claude Code por @midudev

Better Claude (midudev/better-claude, licencia MIT) es una suite de extensiones (plugins y mods) desarrollada por Miguel Ángel Durán (@midudev) que optimiza la interfaz de terminal, la observabilidad de consumo y el flujo de trabajo en Claude Code.

Aporta 3 plugins principales de uso diario:

  1. Image Preview: Previsualización flotante instantánea de imágenes al pasar el ratón (hover) sobre tokens [Image #N].

  2. Sub Meter: Barra persistente de consumo de la suscripción (ventanas de 5 horas y 7 días) con cuenta regresiva.

  3. Commit: Comando /commit que divide los cambios en Conventional Commits limpios usando Claude Haiku 5.5 sin exponer secretos ni atribuciones.

🧭 Arquitectura: Cómo se Integran los Mods en Claude Code

A diferencia de herramientas externas que requieren procesos secundarios pesados en segundo plano, Better Claude se ejecuta de forma nativa dentro del motor de Claude Code mediante la API interna de Hooks y Mods TUI:

flowchart TD
    User["👨‍💻 Desarrollador en Terminal (Claude Code TUI)"] --> CC["⚡ Motor Claude Code (Node 22 / React Ink)"]

    subgraph BetterClaude["🧩 Suite Better Claude (midudev/better-claude)"]
        IP["🖼️ Image Preview\n(Hook 'ui.render' + Hover X11/macOS/Kitty)"]
        SM["📊 Sub Meter\n(Hook 'session.measure' + 'ui.render' en footer)"]
        CM["🚀 /commit\n(Slash command nativo con Haiku 5.5 + Git)"]
        AF["⏳ /after & /before (Cola)\n(Intercepta 'turn.complete' y aisla contexto)"]
        UH["⚡ Modifiers: _haiku y +think\n(Inyección dinámica en 'turn.step')"]
    end

    CC <--> BetterClaude
    IP --> Tooltip["🪟 Ventana Flotante HUD / Renderizado en Bloques UTF-8"]
    SM --> Footer["⏱️ '5h ━━━━━━──── 58% · 2h 10m'"]
    CM --> GitDiff["📦 Conventional Commits en Git"]

🦁 Los 3 Plugins Principales de Better Claude

1. 🖼️ Image Preview: Vista Previa Flotante al Hacer Hover

Vista Previa Instantánea sin Salir de la Terminal

Al pegar una imagen o captura en Claude Code, se genera el identificador [Image #1]. Al posar el cursor del ratón sobre él, se abre una ventana flotante o tarjeta de vista previa instantánea. Al hacer clic, se abre en el visor predeterminado del sistema (Preview en macOS, xdg-open en Linux, explorer en Windows).

  12
╭──────────────────────────────────────────╮
│▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀│
│▃▁▁▘▘▁▃▀▀▖▗▀▖▗▀▏▊▎▗▘▃▗▀▖▀▂▁▉▚▉▘▏▗▀▖▗▀▖▀▀▀│   ← Imagen en color sobre el transcript
│[Image #1] PNG · 151 KB                   │
╰──────────────────────────────────────────╯
[Image #1] hover to preview · click to open
  • En macOS: Ventana flotante AppKit HUD con esquinas redondeadas y desenfoque nativo vía osascript.
  • En Linux (X11 / XWayland): Ventana emergente Tkinter con la imagen optimizada a PNG vía ImageMagick.
  • En Terminales Modernas (Ghostty / Kitty): Renderizado directo en alta resolución utilizando el protocolo gráfico nativo de Kitty.
  • En Terminales Convencionales: Muestreo en bloques de semitonos UTF-8 (▀ ▂ ▎ ▚) en True Color sin desfasar el scroll del transcript.

2. 📊 Sub Meter: Monitor de Consumo en Tiempo Real

Control Total de tu Cuota de Suscripción

Agrega una barra de progreso viva en la esquina inferior derecha del terminal, justo al lado del modo de permisos, alternando automáticamente cada 8 segundos entre la ventana de 5 horas y la ventana de 7 días (semanal).

⏵⏵ auto mode on                                   5h ━━━━━━──── 58% · 2h 10m
  • Alertas Visuales por Color: La barra cambia de color según el agotamiento: blanco/cian (normal), amarillo () y rojo ().
  • Tiempo de Reseteo: Indica exactamente cuántas horas y minutos faltan para la renovación de la cuota.
  • Persistencia: Almacena la última lectura en el almacén de sesión ($.store) para mostrar el estado inmediatamente al reiniciar el CLI.
  • Optimización de Espacio: Oculta el mensaje redundante (shift+tab to cycle) para no saturar el pie de página.

3. 🚀 Commit: Commits Seguros y Profesionales con Haiku 5.5

Commits Convencionales Cero-Riesgo

El comando /commit inspecciona el estado de Git (git status, git diff HEAD), evalúa los cambios con Claude Haiku 5.5 (económico y ultrarrápido) y genera commits atómicos bien clasificados.

❯ /commit
 
  Commit: what to do with these changes?
  ❯ 1. Commit + push (Recommended)
    2. Commit only
    3. Commit on a new branch
  • Opciones Interactivas:
    1. Commit + push (Recomendado): Confirma en la rama actual y ejecuta git push -u origin HEAD.
    2. Commit only: Confirma localmente sin enviar al repositorio remoto.
    3. Commit on a new branch: Crea automáticamente una rama descriptiva (ej. feat/auth-dialog), commitea y la sube.
  • Protección contra Fuga de Secretos: Nunca añade archivos .env*, credenciales o claves privadas.
  • Atribución Limpia: No agrega trailers tipo Co-Authored-By: Claude, enlaces de sesión ni marcas de IA; el commit queda como autoría humana pura bajo el estándar Conventional Commits (feat(scope): summary).

🔮 Bonus: Plugins Ocultos / En Desarrollo en el Repositorio

En el repositorio oficial de Better Claude existen además 4 herramientas avanzadas en fase activa:

Plugin AdicionalComando / SintaxisFuncionalidad Destacada
after/after <tarea> · /before <tarea>Cola de tareas asíncrona: Permite encolar instrucciones para cuando Claude termine la tarea actual sin interrumpir ni alterar su contexto de trabajo (steering avoidance). Soporta lenguaje natural (“/after quita lo del readme”).
use-haiku_prompt...Ejecución rápida: Si inicias un prompt con un guion bajo _, ese turno específico se ejecuta en Claude Haiku 5.5, ahorrando tokens y costo.
think-hard+prompt...Máximo razonamiento: Si inicias el prompt con +, fuerza el parámetro effort: 'max' para ese turno de resolución compleja.
token-meterIndicador en footerMuestra tokens de entrada (azul), salida (verde), lecturas de caché (naranja) y el acumulado de la sesión.

⚡ Guía de Instalación y Configuración

Instalación Paso a Paso en Claude Code

1. Registrar el Marketplace Oficial

Ejecuta dentro de tu sesión de Claude Code:

/plugin marketplace add midudev/better-claude

2. Instalar los Plugins Deseados

# Instalar Image Preview
/plugin install image-preview@better-claude
 
# Instalar Sub Meter
/plugin install sub-meter@better-claude
 
# Instalar Commit
/plugin install commit@better-claude

(Opcional: si deseas probar la cola de tareas asíncrona: /plugin install after@better-claude)

3. Configuración Recomendada de Claude Code

Para aprovechar al máximo el soporte de ratón y hover de Image Preview, asegúrate de tener activada la interfaz en pantalla completa:

# En el archivo de configuración ~/.claude/settings.json:
{
  "tui": "fullscreen"
}

O escribe /config dentro de Claude Code y activa el modo Fullscreen TUI.

Vista Gráfica

Retroenlaces