claude-subagent-statusline

Español | English

claude-subagent-statusline

Plugin para Claude Code que muestra una statusline en vivo con la carpeta del proyecto, el modelo y effort activos, el costo estimado de la sesión, el uso de la ventana de contexto, los contadores de sub-agentes (Task) en tiempo real, el tiempo transcurrido y los rate limits de 5h y 7d. Mantiene además un historial persistente y consultable de cada delegación entre sesiones. Node.js puro (18 o superior) — funciona en Windows, macOS y Linux.

Vista previa

my-app [Opus 4.7 (high) · $1.42] ████░░░░░░ 42% │ ⏱ 14m 32s │ ⚡ 2 · ✓ 7 · ✗ 0 │ 5h: 13% (reset in 1h 8m) · Week: 4% (reset in 5d 15h)

Significado de los íconos

Ícono	Qué significa
⚡	Sub-agentes (Tasks) en ejecución en este momento — incluye los lanzados en foreground (Agent) Y los background (Agent con run_in_background: true)
✓	Sub-agentes completados con éxito
✗	Sub-agentes que fallaron
⏱	Tiempo transcurrido desde el inicio de la sesión

Cómo se construye cada segmento

Carpeta del proyecto (my-app en negrita al inicio) — basename de workspace.current_dir, con cwd como fallback. Si el directorio coincide con tu $HOME, se muestra como ~. Si Claude Code no expone ninguno de los dos campos, el prefijo se omite. Útil para distinguir sesiones cuando tenés varias instancias abiertas en distintos repos.

Bracket del modelo ([Opus 4.7 (high) · $1.42]) — combina tres datos:

• Nombre del modelo: se obtiene parseando model.id (por ejemplo, claude-opus-4-7 → Opus 4.7). Si el campo no está disponible, se cae al fallback model.display_name con anotaciones tipo (1M context) o (200K context) removidas para mantener el bracket compacto.
• Effort level: entre paréntesis después del modelo aparece el effort.level activo (low, medium, high, xhigh o max). Refleja cambios mid-sesión hechos con /effort. Si el modelo no soporta effort, se omite.
• Costo estimado: el sufijo · $X.XX muestra el costo total de la sesión en USD, calculado del lado del cliente por Claude Code. Acumula el costo del agente principal y todos los sub-agentes lanzados con Task. Si Claude Code no expone cost, el sufijo se omite.

Barra de contexto (████░░░░░░ 42%) — tiene 10 celdas y cambia de color según el porcentaje: verde por debajo del 50%, amarillo entre 50% y 79%, rojo a partir del 80%. Los contadores de sub-agentes (⚡ ✓ ✗) y el segmento ⏱ se muestran siempre, incluso cuando los valores son cero.

Jerarquía de separadores — la statusline usa dos tipos de separador con un significado distinto: │ (barra pesada) marca secciones (bracket del modelo / barra y elapsed / contadores / rate limits), mientras que · (medio) separa items dentro de una sección (entre ⚡ ✓ ✗ y entre 5h y Week).

Rate limits (5h: X% (reset in …) · Week: X% (reset in …)) — uso actual de los rate limits de 5 horas y 7 días reportados por Claude Code, junto con el tiempo restante hasta el próximo reset. El porcentaje se colorea con la misma escala que la barra (verde / amarillo / rojo) para que detectes a simple vista cuándo te estás acercando al límite. El delta de reset se formatea como Xm por debajo de una hora, Xh Ym por debajo de un día, o Xd Yh para ventanas más largas. Si tu cuenta no expone rate limits, el segmento se omite entero.

Instalación

claude plugin marketplace add GerardoFC8/claude-subagent-statusline
claude plugin install claude-subagent-statusline@claude-subagent-statusline

Reinicia Claude Code después de instalar. El archivo settings.json no se recarga en caliente — los hooks del plugin no se activarán hasta que la aplicación se reinicie por completo.

Actualizar a la última versión

Si ya tenés el plugin instalado y querés traer la versión más reciente:

claude plugin update claude-subagent-statusline@claude-subagent-statusline

Reinicia Claude Code después de actualizar para que los hooks se recarguen. La autoconfiguración del statusLine se ejecuta en cada SessionStart y reescribe automáticamente la ruta absoluta del script para que apunte a la nueva versión — no hace falta tocar settings.json a mano.

Auto-update (opcional)

Si preferís que las actualizaciones se apliquen solas en cada inicio de Claude Code:

1. Corré /plugin dentro de Claude Code
2. Cambiá a la pestaña Marketplaces
3. Seleccioná claude-subagent-statusline
4. Pulsá Enable auto-update

Las marketplaces de terceros tienen auto-update desactivado por defecto — basta con prenderlo una vez. Después es transparente: cada vez que inicies Claude Code se actualiza sola si hay nueva versión.

Configuración

El plugin se autoconfigura en la primera sesión tras instalarlo: