Time Tracking

Track time on tasks directly from your code editor. A persistent status bar timer runs alongside your code, and a dedicated panel shows your time log, charts, and team hours.

The Problem This Solves

Logging time in a separate browser tab after the fact is inaccurate. You forget what you worked on, estimate instead of measure, and miss billable hours. The harder time tracking is, the less your team uses it.

GitScrum Studio makes time capture effortless. The timer is always visible in the status bar. One click to start, one click to stop. Time entries link automatically to the correct task, project, and user.

What You Are Looking At

The Status Bar Timer

At the bottom of your editor, the status bar shows a clock icon with a timer display. This timer is always visible regardless of which file or panel you have open.

When idle:

🕐 00:00:00

When active:

🕐 01:23:45 | PROJ-123          (yellow background)

The active state shows elapsed time and the task code. The yellow background makes it impossible to miss.

Starting a Timer

Click the clock icon in the status bar. A QuickPick menu appears:

When no timer is running:

Selecting Start Timer loads your tasks across all workspaces. The picker shows:

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

Each item displays the task code, current workflow status, and title. Type to search by any of these fields.

Select a task and the timer starts immediately. The status bar updates to show elapsed time with the yellow background.

Stopping a Timer

Click the status bar timer when it is running. The QuickPick menu shows:

Selecting Stop Timer opens an input field showing the task code and total elapsed time. Add an optional comment describing what you worked on, then press Enter to save.

The time entry is logged and linked to the task, project, and your user account.

Switching Tasks

Select 🔄 Switch Task from the active timer menu. The current timer stops automatically, the time entry is saved, and a new task picker opens immediately. This lets you move between tasks without losing any tracked time.

Discarding a Timer

Select 🗑 Discard Timer to cancel the active timer without saving. No time entry is created. Use this when you started a timer on the wrong task or tracked non-work time accidentally.

Timer Persistence

The timer saves its state to the editor's storage every 60 seconds. This means:

• Close the editor → timer resumes when you reopen
• Restart your computer → timer picks up from the last saved state
• Open on a different machine → the extension syncs with the server's active timer on startup

If the server has an active timer that differs from local state, the extension synchronizes to match the server.

The Time Tracking Panel

Click Time Tracking in the sidebar tree (under your active project) to open the dedicated panel. This panel has three tabs:

Log Tab

The default view shows a list of time entries for the current project.

Header statistics:

Period filter: Filter entries by All Time, This Week, This Month, Last Month, or custom date range.

Entry list: Each entry shows:

• Task code and title
• Duration
• Date and time
• Billable indicator
• User who logged the entry

Click any time entry's task to open the task drawer with full editing capabilities.

Charts Tab

Visual analytics for time tracking data. View time distribution across tasks, track daily and weekly patterns, and analyze billable vs. non-billable ratios.

Team Tab

Team member time tracking overview. See who logged time, total hours per team member, and time distribution across the project.

Time Tracking from the Command Palette

All timer commands are available from the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

Pro Tips (Once You Are Comfortable)

• Start timer first, code second. Make it a habit to start the timer before writing any code. The one-click status bar workflow makes this nearly frictionless.

• Use Switch Task instead of stop + start. It saves time and ensures no gap between entries.

• Split view. Open the Time Tracking panel alongside your code to monitor hours as you work.

• Check the team tab before standup. See what everyone worked on and how long without asking.

Permissions

The extension respects your GitScrum account permissions:

• Agency Owners and Managers: Full access to all time entries, team analytics, and reporting
• Developers: Can start and stop timers, view their own entries, and see project analytics
• Clients: Cannot access time tracking

How to Report a Problem or Request a Feature

If the timer behaves unexpectedly or time entries are not logging correctly, open a support ticket in the GitScrum web application. Navigate to Support Tickets in the sidebar and describe the issue. Include the extension version (visible in the Extensions view) and your editor name and version.