Manage and log time spent on GitLab Issues and Merge Requests directly from Visual Studio Code.
This extension simplifies tracking your work by allowing you to quickly log time against any open GitLab Work Item across your configured projects.
✨ Features
Quick Time Logging: Use the Command Palette (Ctrl+Shift+P or Cmd+Shift+P) to quickly log time spent on an issue or merge request.
Scoped Logging: Commands available to log time across All Projects or limit the search to items in your Current Project (based on the active Git repository).
Real-time Configuration: Securely configure your GitLab URL, Token, and Username via VS Code Settings.
🛠️ Commands
Access these commands via the VS Code Command Palette (F1 or Ctrl+Shift+P):
Command
Description
GitLab (gitcrane): Log Time Spent on a WorkItem across all Projects
Fetches open Issues/MRs from all projects you have access to.
GitLab (gitcrane): Log Time Spent on a WorkItem for the current Project
Attempts to infer the project from the active Git repository and fetches relevant open items.
⚙️ Extension Settings
This extension contributes the following settings, which can be configured in File > Preferences > Settings (or Code > Settings on macOS) under the "GitLab Time Tracker" section:
Setting
Type
Description
gitcrane.url
string
The base URL for your GitLab instance (e.g., https://gitlab.example.com).
gitcrane.token
string
Your Personal Access Token (PAT) from GitLab. Required scope: api
gitcrane.username
string
Your GitLab username (used for filtering work items).
gitcrane.remoteName
string
Your GitLab remote repo alias name given in the local git repo (e.g, origin).
Personal Access Token (PAT) Setup
To create a PAT with the necessary permissions:
Navigate to your GitLab profile User Settings -> Access Tokens.
Create a new token.
Ensure you grant the api scope.
Paste the generated token into the gitlabTimeTracker.token setting.
⚠️ Requirements
You must have the official VS Code Git extension enabled.
The Git repository must have a remote URL configured (origin is preferred).
