TrackLab Help

Learn how to setup and use TrackLab to visualize and track your GitLab time logs.

Getting Started

🚀 Step 1: Get Your GitLab Personal Access Token

1 Go to your GitLab instance (e.g., gitlab.com or your company's GitLab)
2 Click on your profile image in the top-left corner
3 Select "Edit profile" from the dropdown menu
4 In the left sidebar, click "Access tokens"
5 Click "Add new token"

⚙️ Step 2: Configure Your Token

Token Settings:

Token name: "TrackLab" (or any name you prefer)
Expiration date: Set to your preference (optional)
Select scopes: Check api (required for full functionality)

Click "Create token"

⚠️ Important: Copy your token immediately! GitLab will only show it once. It looks like: glpat-xxxxxxxxxxxxxxxxxxxx

🔧 Step 3: Setup TrackLab

1 Click the "Settings" button in TrackLab
2 Enter your GitLab URL (e.g., https://gitlab.com or https://gitlab.yourcompany.com)
3 Paste your Personal Access Token
4 Click "Save"

Time Entry Tags

🏷️ Set Up Your Tags

1 Click the "Settings" button and open the "Tracking" tab
2 Enter your tags in "Time Entry Tags", separated by commas (e.g., homework, remote, office)
3 Click "Save"

How matching works: a time entry is tagged when its summary contains one of your tags, ignoring upper and lower case. The issue title and project name are not checked.

⏱️ Adding Tagged Time

Once tags are configured, the Add Time modal shows a checkbox for each tag under "Time Entry Tags". Checking one adds the tag to the entry's summary. You can also simply type the tag into the summary yourself, including when logging time directly in GitLab.

📅 How Tagged Time Appears

Tagged cards sit at the bottom of the day with a purple badge naming the matching tag. While tagged time is excluded from the daily target (the default), they also get a dashed border.
If one issue has both regular and tagged entries on the same day, it shows two cards: a work card with the regular time and a tagged card with the tagged time. Each card has its own entry list, delete controls and drag & drop.
Each day lists its tagged time under "Tags:", and the "Weekly Tag Summary" panel totals tagged time for the whole week.

🎯 Tagged Time and Your Daily Target

By default, tagged time does not count toward your daily target: the day's total shows only regular work, and the day turns green only when that work meets the target. To count tagged time as well, enable "Count tagged entries in daily target" in the "Tracking" tab of Settings.

Navigation Shortcuts

💻 Desktop Shortcuts

← Previous week

→ Next week

T Jump to this week

L Jump to last week

R Refresh current view

A Add time entry

E Leave Early (when enabled)

📱 Mobile Gestures

👈 Swipe left → Next week

👉 Swipe right → Previous week

👆👆 Double tap → Jump to this week

Ready to Take Control of Your Time?

Join thousands of developers who use TrackLab to visualize and optimize their GitLab time tracking.

Get Started Now - It's Free!

No signup required. Your data stays private in your browser.