GitScrum / Docs

Timer

Controla el tiempo de trabajo desde tu terminal. Inicia, para, registra tiempo manual y genera reportes con GitScrum CLI.

⚠️ BETA — GitScrum CLI está en desarrollo activo. Open source bajo licencia MIT. Disponible en GitHub.

Control de tiempo sin fricción. Inicia el timer, continúa codificando.


Comandos Disponibles

ComandoDescripción
gitscrum timerVer estado del timer activo
gitscrum timer start [uuid]Iniciar timer para tarea
gitscrum timer stopParar y registrar tiempo
gitscrum timer logRegistrar tiempo manualmente
gitscrum timer reportReporte de tiempo
gitscrum timer productivityMétricas de productividad

Iniciar Timer

Inicia el timer para la tarea actual (detectada desde tu rama Git):

gitscrum timer start
⏱️  Timer iniciado para GS-1234: Refactorizar módulo auth
    Desde: 09:15 AM

O especifica una tarea:

gitscrum timer start a1b2c3d4

Agrega un mensaje:

gitscrum timer start -m "Implementando validación"

Ver Timer Activo

gitscrum timer
⏱️  Timer Activo

Tarea:    GS-1234 - Refactorizar módulo auth
Proyecto: backend-api
Duración: 01:47:32
Inicio:   09:15 AM

Parar Timer

Para y registra el tiempo automáticamente:

gitscrum timer stop
⏱️  Timer detenido

Tarea:     GS-1234 - Refactorizar módulo auth
Duración:  2h 34m
Total hoy: 4h 49m

✓ Tiempo registrado

Registrar Tiempo Manual

Usa cuando olvidaste iniciar el timer:

gitscrum timer log

Flags disponibles:

# Con código de tarea
gitscrum timer log --code a1b2c3d4

# Con duración
gitscrum timer log --duration 2h30m

# Con mensaje
gitscrum timer log -m "Revisión de código"

Reporte de Tiempo

Reporte Personal

gitscrum timer report
⏱️  Reporte de Tiempo - Esta Semana

Lun   │ ████████████████░░░░ │ 6h 30m
Mar   │ ████████████████████ │ 8h 15m
Mié   │ ██████████████░░░░░░ │ 5h 45m
Jue   │ ██████████████████░░ │ 7h 20m
Vie   │ ████████░░░░░░░░░░░░ │ 3h 15m

Total: 31h 05m

Reporte Semanal

gitscrum timer report --week

Reporte del Equipo

gitscrum timer report --team

Métricas de Productividad

gitscrum timer productivity
📊 Productividad - Últimos 7 días

Media diaria:    6h 13m
Foco continuo:   2h 45m
Tareas/día:      4.2

Distribución:
  Desarrollo    ████████████████░░░░  68%
  Revisión      ████░░░░░░░░░░░░░░░░  18%
  Reuniones     ███░░░░░░░░░░░░░░░░░  14%

Con período específico:

gitscrum timer productivity --period month

Ejemplos Prácticos

Flujo Diario

# Mañana: iniciar trabajo
gitscrum timer start

# Almuerzo: parar timer
gitscrum timer stop

# Tarde: retomar
gitscrum timer start

# Fin del día: parar y verificar
gitscrum timer stop
gitscrum timer report

Registro Manual post-reunión

gitscrum timer log --duration 1h -m "Reunión de planificación"

Flags Disponibles

FlagDescripción
-m, --messageAgregar descripción
--weekReporte semanal
--teamReporte del equipo
--periodPeríodo (week, month)
--durationDuración para log manual
--codeCódigo de la tarea