---
name: dotrino-terminal-note
description: Mantiene al día la tarea en curso en la tarjeta «de qué va» de la consola de Dotrino Terminal en la que corres (la ve el dueño flotando sobre la consola, en todas sus pantallas). Úsalo AL EMPEZAR cada tarea, cuando la tarea cambia de rumbo, y al terminar o quedar esperando al usuario, siempre que exista la variable de entorno DOTRINO_TERMINAL_CONSOLE. También cuando el usuario diga «nota de la consola», «el flotante», «la tarjeta» o «de qué va este chat». Orden: `dotrino-terminal note --task … --title …` (la tarea y el título de la consola). Las notas personales del dueño NO se tocan.
---

# La tarea en curso de la consola (Dotrino Terminal)

Cada consola de Dotrino Terminal tiene una **nota** que sale en una tarjeta flotante sobre la
consola y, su primera línea, en la lista de consolas. Existe para que el dueño, con varias consolas
abiertas, sepa **de qué va la tarea en curso de cada una** sin entrar a leerla.

La tarjeta tiene dos partes, y son dos campos distintos:

- **La tarea**: es TUYA. La pones con `--task`. El dueño la ve y puede quitarla, no la edita.
- **El título**: también es TUYO, con `--title`. Es el nombre de la consola en la tarjeta, en la
  lista y en la barra de la ventana.
- **Las notas**: son **personales del dueño**. Las escribe él desde la tarjeta. No son tuyas.

## Regla dura: las notas personales no se tocan

**Usa SOLO `dotrino-terminal note --task … --title …`.** Esa orden escribe la tarea y el título, y
no puede tocar las notas del dueño.

**Prohibido**, salvo que el usuario te lo pida con esas palabras en ese momento:

- `dotrino-terminal note "texto"` y `dotrino-terminal note -` (reemplazan SUS notas)
- `dotrino-terminal note --add …` (escribe en sus notas como si fueras él)
- `dotrino-terminal note --clear` (borra sus notas)

No reescribas, ordenes, corrijas ni resumas lo que él escribió. Tampoco lo copies a tus líneas.

## Cuándo

1. Comprueba que corres dentro de una consola: `echo "$DOTRINO_TERMINAL_CONSOLE"`. Vacío = no hay
   consola ni tarjeta: no hagas nada y no lo menciones.
2. **Al empezar una tarea**: pon la tarea.
3. **Mientras pasan cosas, no solo al principio y al final.** El dueño mira la tarjeta para saber
   por dónde vas sin leer la consola: una tarjeta que dice lo de hace veinte minutos no le sirve.
   Actualízala cada vez que:
   - terminas un paso («Hecho: agente publicado»);
   - publicas, despliegas o subes algo;
   - algo falla o te bloquea;
   - cambia el rumbo o llega otro encargo a mitad;
   - quedas **esperando** algo (una compilación, CI, una prueba larga, su respuesta): dilo.
4. **Al terminar**: dilo en la primera línea (`Terminado: …`) y deja lo que quede pendiente.

**Una tarjeta vieja es peor que una vacía.** Nunca termines un turno dejando un `Ahora:` que ya no
ocurre: lo último que haces antes de responder, si en el turno hiciste algo, es poner la tarea
como queda (`Terminado: …`, o qué esperas). Si ya no hay tarea, quítala (`--task ''`).

En una tarea larga eso son varias actualizaciones; es lo esperado. Una orden cada vez, sin
anunciarlo ni comentarlo en la respuesta.

## Cómo

```bash
# la tarea por la entrada estándar; el título, en la misma orden y SIEMPRE después de --task
dotrino-terminal note --task - --title 'Login de facturero' <<'EOF_TASK'
Hecho: el formulario
Ahora: la validación
Falta: probar con firma real
2026-10-16 14:40:12 · Modelo: Opus 5.5 · 83% 167min 82% 7d -4%
EOF_TASK

dotrino-terminal note --task ''                # quita tu tarea y tu título (lo del dueño se queda)
dotrino-terminal note                          # solo LEER: tu tarea (con «▸ ») y debajo sus notas
```

No hace falta decir qué consola: es la tuya.

## Qué escribir

- **El título (`--title`) = de qué va la tarea, en pocas palabras** (hasta ~40 caracteres): «Login
  de facturero», «Tarjeta de notas en Terminal». No «Trabajando en lo que pidió el usuario». Sin
  él la consola se llama como tu sesión, que se nombró con el primer mensaje y ya no tiene que ver
  con lo que haces: **el dueño lee ese nombre para saber qué consola es cuál**.
  Mándalo en cada actualización. Mientras la tarea sea la misma, **el mismo título** (no lo
  reescribas con otras palabras: lo reconoce por él). Cuando llega otro encargo, cámbialo.
- La tarea (`--task`) es el estado, en tres o cuatro líneas: `Hecho:` (lo ya cerrado), `Ahora:` (lo que haces en
  este momento), `Falta:` y, si aplica, `Espera:` (a qué). Reescríbela entera cada vez: es el
  estado actual, no un historial.
- **La última línea dice qué modelo eres**: `Modelo: Opus 5.5` (el nombre con el que te presentas,
  tal como lo dice tu contexto; no lo adivines ni pongas el identificador largo). Va siempre, en
  cada actualización: el dueño tiene varias consolas con modelos distintos y quiere verlo ahí.
  **Delante, la fecha y hora** de esa actualización (`date '+%F %T'`, formato
  `yyyy-mm-dd hh:mm:ss`), para que el dueño vea de cuándo es la tarjeta.
  **Al lado, el saldo de uso**: `2026-10-16 14:40:12 · Modelo: Opus 5.5 · 83% 167min 82% 7d -4%` (sesión restante,
  minutos al reinicio, semana restante, días al reinicio, margen óptimo semanal). Sácalo en cada
  actualización con `bash ~/.claude/usage-throttle/tts-synth.sh --compact`; no copies el de la
  vez anterior. Si la orden no existe o no devuelve nada, solo `Modelo: …`.
- En el idioma del usuario. Sin secretos, llaves ni rutas con credenciales: la nota la ven todos
  los aparatos de la cuenta.
- Al terminar no la quites: di que terminó (`Terminado: …`).

## Si falla

- «no sé de qué consola» / `no console to act on`: no corres dentro de Dotrino Terminal. Sigue sin nota.
- «el agente que corre es anterior a la 0.41.0 y no guarda el título»: la tarea sí quedó puesta.
  Díselo al usuario una vez y sigue mandando solo `--task`, con la tarea en una frase como primera
  línea.
- «el agente que corre es anterior a la 0.37.0 y no guarda tareas», o «el agente no contestó»:
  el agente de esta máquina es viejo. **No uses las otras formas como sustituto**: díselo al
  usuario una vez (`npm i -g @dotrino/terminal-agent@latest` y reiniciarlo él) y sigue sin tarea.
- **Nunca reinicies el agente tú**: corres dentro de él y reiniciarlo cierra esta consola.
