Claudoro es un temporizador Pomodoro que se ejecuta dentro del terminal de Claude Code, la herramienta de programación asistida por IA de Anthropic, y muestra una cuenta atrás en directo en la línea de estado, justo donde el usuario ya fija la mirada. Su principal propuesta es eliminar el cambio de contexto: frente a los temporizadores habituales (aplicaciones en la barra de menús, pestañas del navegador o el móvil), Claudoro ocupa una superficie ya visible y sigue funcionando aunque se oculten otras interfaces.
La instalación requiere Node 22 o superior y se realiza con un único comando (npm install -g claudoro). A continuación, pomo setup integra la herramienta en Claude Code de forma idempotente: crea el comando /pomo, modifica el bloque statusLine de settings.json (con copia de seguridad previa) y registra todos los cambios en un manifiesto para facilitar la desinstalación. En menos de dos minutos el temporizador aparece en pantalla al iniciar /pomo start.
Claudoro incorpora un comando /pomo con más de una docena de subcomandos (start, pause, resume, stop, skip, reset, next, back, extend, status, mode, view, mute, note, tag, label, log, stats, undo, restore, guide, version, help). Ofrece tres modos de visualización (minimal, classic y full), tres modos de avance del ciclo (auto, balanced y manual) y permite personalizar por sesión las duraciones de trabajo, descanso corto, descanso largo y la frecuencia de descansos largos mediante flags en línea de comandos, sin ficheros de configuración.
El registro de bloques completados se almacena de forma local e inmutable en ficheros JSONL bajo el directorio XDG de estado. A partir de estos registros se calculan estadísticas como la racha actual, un mapa de calor de foco y los tags más utilizados. Con pomo stats --web se genera un dashboard HTML autocontenido que se abre en el navegador sin depender de red ni de servicios externos.
Un único temporizador global se muestra en todas las sesiones abiertas de Claude Code; el control funciona desde cualquiera de ellas y solo se dispara una alarma por fase, con independencia del número de procesos activos. La herramienta es completamente local: no realiza llamadas de red, no requiere cuentas y no envía telemetría. Entre las variables de entorno disponibles se encuentran CLAUDORO_HIDE, CLAUDORO_COLOR, CLAUDORO_EMOJI y CLAUDORO_LINKS.