GitScrum / Docs
Available for VS Code, Cursor, Windsurf, and any VS Code forkInstall from Marketplace

Controle de Tempo

Registre tempo em tarefas diretamente do seu editor de código. Um cronômetro persistente na barra de status funciona junto com o seu código, e um painel dedicado exibe seu registro de tempo, gráficos e horas da equipe.


O Problema que Isso Resolve

Registrar tempo em uma aba separada do navegador depois do fato é impreciso. Você esquece no que trabalhou, estima em vez de medir e perde horas faturáveis. Quanto mais difícil é o controle de tempo, menos sua equipe o utiliza.

O GitScrum Studio torna o registro de tempo simples. O cronômetro está sempre visível na barra de status. Um clique para iniciar, um clique para parar. As entradas de tempo são vinculadas automaticamente à tarefa, projeto e usuário corretos.


O que Você Está Vendo

O Cronômetro na Barra de Status

Na parte inferior do seu editor, a barra de status exibe um ícone de relógio com o cronômetro. Esse cronômetro está sempre visível independentemente de qual arquivo ou painel você tenha aberto.

Quando inativo:

🕐 00:00:00

Quando ativo:

🕐 01:23:45 | PROJ-123          (fundo amarelo)

O estado ativo mostra o tempo decorrido e o código da tarefa. O fundo amarelo torna impossível não perceber.


Iniciando um Cronômetro

Clique no ícone de relógio na barra de status. Um menu QuickPick aparece:

Quando nenhum cronômetro está rodando:

OpçãoDescrição
▶ Start TimerAbre um seletor de tarefas para escolher qual tarefa rastrear
📜 View Time EntriesAbre o painel de Controle de Tempo
📊 Open Time Tracking PanelAbre a visualização de análises

Ao selecionar Start Timer, suas tarefas de todos os workspaces são carregadas. O seletor exibe:

PROJ-123 · In Progress · Implement login form
PROJ-124 · To Do · Design user profile page
PROJ-125 · In Review · Fix navigation bug

Cada item exibe o código da tarefa, o status atual do fluxo de trabalho e o título. Digite para buscar por qualquer um desses campos.

Selecione uma tarefa e o cronômetro inicia imediatamente. A barra de status é atualizada para mostrar o tempo decorrido com o fundo amarelo.


Parando um Cronômetro

Clique no cronômetro da barra de status quando ele estiver rodando. O menu QuickPick exibe:

OpçãoDescrição
⏹ Stop TimerPara e salva a entrada de tempo
🔄 Switch TaskPara o cronômetro atual e inicia um novo em uma tarefa diferente
🗑 Discard TimerCancela o cronômetro sem registrar nenhum tempo
📜 View Time EntriesAbre o painel de Controle de Tempo
📊 Open Time Tracking PanelAbre a visualização de análises

Ao selecionar Stop Timer, um campo de entrada aparece mostrando o código da tarefa e o tempo total decorrido. Adicione um comentário opcional descrevendo no que você trabalhou e pressione Enter para salvar.

A entrada de tempo é registrada e vinculada à tarefa, ao projeto e à sua conta de usuário.


Alternando Tarefas

Selecione 🔄 Switch Task no menu do cronômetro ativo. O cronômetro atual para automaticamente, a entrada de tempo é salva e um novo seletor de tarefas abre imediatamente. Isso permite alternar entre tarefas sem perder nenhum tempo registrado.


Descartando um Cronômetro

Selecione 🗑 Discard Timer para cancelar o cronômetro ativo sem salvar. Nenhuma entrada de tempo é criada. Use isso quando você iniciou o cronômetro na tarefa errada ou registrou tempo não produtivo acidentalmente.


Persistência do Cronômetro

O cronômetro salva seu estado no armazenamento do editor a cada 60 segundos. Isso significa:

  • Fechar o editor → o cronômetro retoma quando você reabrir
  • Reiniciar o computador → o cronômetro continua do último estado salvo
  • Abrir em outra máquina → a extensão sincroniza com o cronômetro ativo do servidor na inicialização

Se o servidor tiver um cronômetro ativo diferente do estado local, a extensão sincroniza para corresponder ao servidor.


O Painel de Controle de Tempo

Clique em Time Tracking na árvore da barra lateral (sob o projeto ativo) para abrir o painel dedicado. Este painel possui três abas:

Aba Registro

A visualização padrão exibe uma lista de entradas de tempo do projeto atual.

Estatísticas do cabeçalho:

MétricaDescrição
Total de HorasSoma de todas as horas registradas no período selecionado
FaturávelHoras marcadas como faturáveis
Não FaturávelHoras não marcadas como faturáveis
Trabalhado HojeHoras registradas hoje

Filtro de período: Filtre entradas por Todo o Período, Esta Semana, Este Mês, Mês Passado ou intervalo de datas personalizado.

Lista de entradas: Cada entrada exibe:

  • Código e título da tarefa
  • Duração
  • Data e hora
  • Indicador de faturável
  • Usuário que registrou a entrada

Clique na tarefa de qualquer entrada de tempo para abrir o drawer da tarefa com capacidades completas de edição.

Aba Gráficos

Análises visuais dos dados de controle de tempo. Visualize a distribuição de tempo entre tarefas, acompanhe padrões diários e semanais, e analise proporções de faturável vs. não faturável.

Aba Equipe

Visão geral do controle de tempo dos membros da equipe. Veja quem registrou tempo, total de horas por membro, e distribuição de tempo no projeto.


Controle de Tempo pela Paleta de Comandos

Todos os comandos do cronômetro estão disponíveis pela Paleta de Comandos (Ctrl+Shift+P / Cmd+Shift+P):

ComandoAção
GitScrum: Start TimerIniciar rastreamento de uma tarefa
GitScrum: Stop TimerParar o cronômetro ativo
GitScrum: Open Time TrackingAbrir o painel de Controle de Tempo

Dicas Avançadas (Quando Você Estiver Confortável)

  • Inicie o cronômetro primeiro, codifique depois. Crie o hábito de iniciar o cronômetro antes de escrever qualquer código. O fluxo de um clique na barra de status torna isso praticamente sem atrito.
  • Use Switch Task em vez de parar + iniciar. Economiza tempo e garante que não haja lacunas entre as entradas.
  • Visualização dividida. Abra o painel de Controle de Tempo ao lado do seu código para monitorar as horas enquanto trabalha.
  • Verifique a aba equipe antes do standup. Veja no que todos trabalharam e por quanto tempo sem precisar perguntar.

Permissões

A extensão respeita as permissões da sua conta GitScrum:

  • Proprietários de Agência e Gerentes: Acesso total a todas as entradas de tempo, análises de equipe e relatórios
  • Desenvolvedores: Podem iniciar e parar cronômetros, visualizar suas próprias entradas e ver análises do projeto
  • Clientes: Não podem acessar o controle de tempo

Como Reportar um Problema ou Solicitar uma Funcionalidade

Se o cronômetro se comportar de forma inesperada ou as entradas de tempo não estiverem sendo registradas corretamente, abra um ticket de suporte na aplicação web do GitScrum. Navegue até Support Tickets na barra lateral e descreva o problema. Inclua a versão da extensão (visível na aba de Extensões) e o nome e versão do seu editor.