Help & Documentation

Learn how GitHours calculates development time and get the most out of your analysis.

Quick Start

1

Create Project

Start by creating a new project to organize your repository analysis.

2

Connect Repository

Enter a Git URL or upload a bundle file for offline repositories.

3

Run Analysis

Configure options like date range and gap threshold, then analyze.

4

View Results

Review time breakdown, export PDF reports, or share via link.

How Time Calculation Works

Understanding GitHours' methodology

"How can software know how long I worked?"

The answer lies in a simple observation: commits are timestamps of your work. When you're actively coding, you commit frequently. When you take a break, there's a gap. GitHours reads this natural rhythm to reconstruct your work sessions.

Visual Example

Your Git History                          Calculated Time
─────────────────────────────────────────────────────────

9:00 AM  ●─── "Initial setup"             +30 min (session start)
              │
              │ 45 min gap
              ▼
9:45 AM  ●─── "Add user model"            +45 min
              │
              │ 30 min gap
              ▼
10:15 AM ●─── "Add validation"            +30 min
              │
              │ ═══════════════════════
              │   3-HOUR GAP (lunch)
              │   New session starts
              │ ═══════════════════════
              ▼
1:15 PM  ●─── "Fix bug in auth"           +30 min (session start)
              │
              │ 45 min gap
              ▼
2:00 PM  ●─── "Add tests"                 +45 min

─────────────────────────────────────────────────────────
SESSION 1: 1h 45min    SESSION 2: 1h 15min    TOTAL: 3 HOURS

The Algorithm (4 Simple Steps)

1. Collect

Gather all commits with timestamps

2. Sort

Order commits chronologically

3. Group

Split into sessions at gaps > 2 hours

4. Calculate

Sum time between commits + 30min per session

Deep Dive

The Bottom Line

GitHours gives you objective, commit-backed time tracking without any manual effort.

No timers to start/stopNo manual time entryRetroactive analysisVerifiable by clientsIndustry-standard methodology

Features

Repository Connections

Connect any Git repository for analysis.

  • Public and private repositories
  • Personal Access Token authentication
  • Bundle file upload for offline repos
  • GitHub, GitLab, Bitbucket support

Analysis Options

Customize how your time is calculated.

  • Configurable gap threshold
  • Date range filtering
  • Author filtering
  • Merge commit handling

Export & Sharing

Share results with clients and teams.

  • Professional PDF reports
  • Shareable public links
  • Detailed methodology included

Frequently Asked Questions

Still have questions?

We're here to help. Reach out and we'll get back to you as soon as possible.

Contact SupportReport Issue