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

Control de Tiempo

Registra tiempo en tareas directamente desde tu editor de código. Un temporizador persistente en la barra de estado funciona junto a tu código, y un panel dedicado muestra tu registro de tiempo, gráficos y horas del equipo.


El problema que resuelve

Registrar tiempo en una pestaña del navegador después del hecho es impreciso. Olvidas en qué trabajaste, estimas en vez de medir y pierdes horas facturables. Cuanto más difícil es el control de tiempo, menos lo usa tu equipo.

GitScrum Studio hace que el registro de tiempo sea sencillo. El temporizador siempre está visible en la barra de estado. Un clic para iniciar, un clic para detener. Las entradas de tiempo se vinculan automáticamente a la tarea, proyecto y usuario correctos.


Lo que estás viendo

El temporizador en la barra de estado

En la parte inferior de tu editor, la barra de estado muestra un ícono de reloj con un temporizador. Este temporizador siempre está visible sin importar qué archivo o panel tengas abierto.

En reposo:

🕐 00:00:00

Cuando está activo:

🕐 01:23:45 | PROJ-123          (fondo amarillo)

El estado activo muestra el tiempo transcurrido y el código de la tarea. El fondo amarillo hace que sea imposible no verlo.


Iniciar un temporizador

Haz clic en el ícono del reloj en la barra de estado. Aparece un menú QuickPick:

Cuando no hay un temporizador activo:

OpciónDescripción
▶ Start TimerAbre un selector de tareas para elegir qué tarea registrar
📜 View Time EntriesAbre el panel de Control de Tiempo
📊 Open Time Tracking PanelAbre la vista de analíticas

Al seleccionar Start Timer se cargan tus tareas de todos los espacios de trabajo. El selector muestra:

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

Cada elemento muestra el código de la tarea, el estado actual del flujo de trabajo y el título. Escribe para buscar por cualquiera de estos campos.

Selecciona una tarea y el temporizador se inicia inmediatamente. La barra de estado se actualiza para mostrar el tiempo transcurrido con el fondo amarillo.


Detener un temporizador

Haz clic en el temporizador de la barra de estado cuando esté en ejecución. El menú QuickPick muestra:

OpciónDescripción
⏹ Stop TimerDetiene y guarda la entrada de tiempo
🔄 Switch TaskDetiene el temporizador actual e inicia uno nuevo en una tarea diferente
🗑 Discard TimerCancela el temporizador sin registrar ningún tiempo
📜 View Time EntriesAbre el panel de Control de Tiempo
📊 Open Time Tracking PanelAbre la vista de analíticas

Al seleccionar Stop Timer se abre un campo de entrada que muestra el código de la tarea y el tiempo total transcurrido. Añade un comentario opcional describiendo en qué trabajaste y presiona Enter para guardar.

La entrada de tiempo se registra y se vincula a la tarea, proyecto y tu cuenta de usuario.


Cambiar de tarea

Selecciona 🔄 Switch Task desde el menú del temporizador activo. El temporizador actual se detiene automáticamente, la entrada de tiempo se guarda y un nuevo selector de tareas se abre inmediatamente. Esto te permite moverte entre tareas sin perder ningún tiempo registrado.


Descartar un temporizador

Selecciona 🗑 Discard Timer para cancelar el temporizador activo sin guardar. No se crea ninguna entrada de tiempo. Úsalo cuando iniciaste un temporizador en la tarea equivocada o registraste tiempo no laboral por accidente.


Persistencia del temporizador

El temporizador guarda su estado en el almacenamiento del editor cada 60 segundos. Esto significa:

  • Cerrar el editor → el temporizador se reanuda cuando lo vuelves a abrir
  • Reiniciar tu computadora → el temporizador retoma desde el último estado guardado
  • Abrir en otra máquina → la extensión se sincroniza con el temporizador activo del servidor al iniciar

Si el servidor tiene un temporizador activo que difiere del estado local, la extensión se sincroniza para coincidir con el servidor.


El panel de Control de Tiempo

Haz clic en Time Tracking en el árbol de la barra lateral (bajo tu proyecto activo) para abrir el panel dedicado. Este panel tiene tres pestañas:

Pestaña Registro

La vista predeterminada muestra una lista de entradas de tiempo para el proyecto actual.

Estadísticas del encabezado:

MétricaDescripción
Horas totalesSuma de todas las horas registradas en el período seleccionado
FacturablesHoras marcadas como facturables
No facturablesHoras no marcadas como facturables
Trabajadas hoyHoras registradas hoy

Filtro de período: Filtra entradas por Todo el tiempo, Esta semana, Este mes, Mes pasado o rango de fechas personalizado.

Lista de entradas: Cada entrada muestra:

  • Código y título de la tarea
  • Duración
  • Fecha y hora
  • Indicador de facturación
  • Usuario que registró la entrada

Haz clic en la tarea de cualquier entrada de tiempo para abrir el cajón de tarea con capacidades de edición completas.

Pestaña Gráficos

Analíticas visuales para los datos de control de tiempo. Visualiza la distribución de tiempo entre tareas, rastrea patrones diarios y semanales, y analiza la proporción entre horas facturables y no facturables.

Pestaña Equipo

Resumen del control de tiempo de los miembros del equipo. Consulta quién registró tiempo, horas totales por miembro del equipo y distribución de tiempo en el proyecto.


Control de tiempo desde la Paleta de Comandos

Todos los comandos del temporizador están disponibles desde la Paleta de Comandos (Ctrl+Shift+P / Cmd+Shift+P):

ComandoAcción
GitScrum: Start TimerIniciar el seguimiento de una tarea
GitScrum: Stop TimerDetener el temporizador activo
GitScrum: Open Time TrackingAbrir el panel de Control de Tiempo

Consejos avanzados (una vez que te sientas cómodo)

  • Inicia el temporizador primero, codifica después. Haz el hábito de iniciar el temporizador antes de escribir cualquier código. El flujo de un clic en la barra de estado lo hace casi sin fricción.
  • Usa Switch Task en vez de detener + iniciar. Ahorra tiempo y asegura que no haya brechas entre entradas.
  • Vista dividida. Abre el panel de Control de Tiempo junto a tu código para monitorear las horas mientras trabajas.
  • Revisa la pestaña de equipo antes del standup. Consulta en qué trabajó cada uno y cuánto tiempo, sin preguntar.

Permisos

La extensión respeta los permisos de tu cuenta de GitScrum:

  • Propietarios de Agencia y Managers: Acceso completo a todas las entradas de tiempo, analíticas de equipo e informes
  • Desarrolladores: Pueden iniciar y detener temporizadores, ver sus propias entradas y consultar las analíticas del proyecto
  • Clientes: No pueden acceder al control de tiempo

Cómo reportar un problema o solicitar una funcionalidad

Si el temporizador se comporta de manera inesperada o las entradas de tiempo no se registran correctamente, abre un ticket de soporte en la aplicación web de GitScrum. Navega a Support Tickets en la barra lateral y describe el problema. Incluye la versión de la extensión (visible en la vista de Extensiones) y el nombre y versión de tu editor.