← Volver al listado de tecnologías ← Índice de Spacecake

Capitulo 15: Status Line y Metricas

Por: Artiko
spacecakeclaude-codemetricasstatus-line

Capitulo 15: Status Line y Metricas

< Volver al Indice del Tutorial

Metricas en vivo

Spacecake muestra metricas en vivo de la sesion de Claude Code directamente en el header badge del terminal. Sin necesidad de ejecutar comandos ni revisar logs, puedes ver de un vistazo el estado de tu sesion.

Metricas disponibles

El badge del terminal muestra tres datos clave:

Modelo actual

Que modelo esta usando Claude en la sesion activa. Puede ser Opus, Sonnet, Haiku u opusplan. Esto es util para confirmar que estas usando el modelo que esperas, especialmente si cambias frecuentemente entre modelos.

Uso de contexto

El porcentaje del context window utilizado. Claude tiene una ventana de contexto limitada y a medida que la conversacion avanza, el porcentaje aumenta. Cuando se acerca al limite, Claude necesita resumir o descartar contexto anterior.

Ver este porcentaje te permite anticipar cuando conviene iniciar una nueva sesion o usar /compact para reducir el contexto.

Costo de sesion

Cuanto ha costado la sesion actual en dolares. Esto te ayuda a monitorear el gasto y tomar decisiones informadas sobre que modelo usar para cada tarea.

Setup automatico

Cuando Spacecake detecta una sesion de Claude Code conectada, configura automaticamente el hook de status line. No necesitas hacer nada manualmente. La configuracion ocurre de forma transparente en el momento de la conexion.

Status line personalizado existente

Si ya tienes un hook de statusLine personalizado en tu configuracion de Claude Code, Spacecake te preguntara si quieres:

Spacecake no modifica tu configuracion sin consentimiento.

Como funciona tecnicamente

El flujo de datos del status line sigue estos pasos:

1. Claude Code ejecuta el hook

En cada render del terminal, Claude Code ejecuta el script de hook configurado como status line.

2. El script lee los datos

El script hook ubicado en ~/.spacecake/.app/hooks/statusline.sh recibe un JSON desde stdin con los datos de la sesion: modelo actual, porcentaje de uso de contexto y costo acumulado.

3. Verificacion del socket

El script verifica si existe el socket ~/.claude/spacecake.sock. Este socket es el canal de comunicacion entre el hook y Spacecake.

4. Envio de datos

Si el socket existe, el script envia los datos a Spacecake via POST al socket. Los datos se transmiten como JSON estructurado.

5. Actualizacion visual

Spacecake recibe los datos y actualiza el badge en el header del terminal con la informacion mas reciente.

Comportamiento sin Spacecake

Si Spacecake no esta corriendo, el hook sale silenciosamente sin generar errores ni afectar a Claude Code. El script verifica la existencia del socket antes de intentar enviar datos, asi que no hay impacto en el rendimiento cuando usas Claude Code fuera de Spacecake.

Configuracion manual

Si por alguna razon necesitas configurar el hook manualmente, edita el archivo ~/.claude/settings.json y agrega la siguiente entrada:

{
  "statusLine": {
    "type": "command",
    "command": "~/.spacecake/.app/hooks/statusline.sh"
  }
}

Despues de hacer cambios manuales en la configuracion, reinicia Claude Code para que tome efecto. Cierra la sesion actual y ejecuta claude nuevamente.

Badge statusline-cleared

Cuando la sesion de Claude Code termina, ya sea porque ejecutaste /exit, presionaste Ctrl+C o el proceso termino naturalmente, Spacecake limpia automaticamente el badge del header.

El badge desaparece para reflejar que ya no hay una sesion activa proporcionando metricas. Si inicias una nueva sesion, el badge vuelve a aparecer con los datos frescos.

Siguiente: Capitulo 16: Task Table —>

← Volver al listado de tecnologías ← Índice de Spacecake