GitScrum / Docs

Timer

Controle o tempo do terminal. Inicie, pare, registre tempo manual e gere relatórios com GitScrum CLI.

⚠️ BETA — GitScrum CLI está em desenvolvimento ativo. Open source sob licença MIT. Disponível no GitHub.

Controle de tempo sem fricção. Inicie o timer, continue codando.


Comandos Disponíveis

ComandoDescrição
gitscrum timerVer status do timer ativo
gitscrum timer start [uuid]Iniciar timer para tarefa
gitscrum timer stopParar e registrar tempo
gitscrum timer logRegistrar tempo manualmente
gitscrum timer reportRelatório de tempo
gitscrum timer productivityMétricas de produtividade

Iniciar Timer

Inicie o timer para a tarefa atual (detectada da branch Git):

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

Ou especifique uma tarefa:

gitscrum timer start a1b2c3d4

Adicione uma mensagem:

gitscrum timer start -m "Implementando validação"

Ver Timer Ativo

gitscrum timer
⏱️  Timer Ativo

Tarefa:   GS-1234 - Refatorar módulo auth
Projeto:  backend-api
Duração:  01:47:32
Início:   09:15 AM

Parar Timer

Para e registra o tempo automaticamente:

gitscrum timer stop
⏱️  Timer parado

Tarefa:     GS-1234 - Refatorar módulo auth
Duração:    2h 34m
Total hoje: 4h 49m

✓ Tempo registrado

Registrar Tempo Manual

Use quando esqueceu de iniciar o timer:

gitscrum timer log

Flags disponíveis:

# Com código da tarefa
gitscrum timer log --code a1b2c3d4

# Com duração
gitscrum timer log --duration 2h30m

# Com mensagem
gitscrum timer log -m "Revisão de código"

Relatório de Tempo

Relatório Pessoal

gitscrum timer report
⏱️  Relatório de Tempo - Esta Semana

Seg   │ ████████████████░░░░ │ 6h 30m
Ter   │ ████████████████████ │ 8h 15m
Qua   │ ██████████████░░░░░░ │ 5h 45m
Qui   │ ██████████████████░░ │ 7h 20m
Sex   │ ████████░░░░░░░░░░░░ │ 3h 15m

Total: 31h 05m

Relatório Semanal

gitscrum timer report --week

Relatório da Equipe

gitscrum timer report --team

Métricas de Produtividade

gitscrum timer productivity
📊 Produtividade - Últimos 7 dias

Média diária:    6h 13m
Foco contínuo:   2h 45m
Tarefas/dia:     4.2

Distribuição:
  Desenvolvimento  ████████████████░░░░  68%
  Revisão          ████░░░░░░░░░░░░░░░░  18%
  Reuniões         ███░░░░░░░░░░░░░░░░░  14%

Com período específico:

gitscrum timer productivity --period month

Exemplos Práticos

Fluxo Diário

# Manhã: iniciar trabalho
gitscrum timer start

# Almoço: parar timer
gitscrum timer stop

# Tarde: retomar
gitscrum timer start

# Fim do dia: parar e verificar
gitscrum timer stop
gitscrum timer report

Registro Manual pós-reunião

gitscrum timer log --duration 1h -m "Planning meeting"

Flags Disponíveis

FlagDescrição
-m, --messageAdicionar descrição
--weekRelatório semanal
--teamRelatório da equipe
--periodPeríodo (week, month)
--durationDuração para log manual
--codeCódigo da tarefa