gitlab_list_commits
Retrieve commit history for GitLab projects or branches, filtered by date range, author, file path, or paginated results. Provides SHA, message, timestamp, author, and stats for each commit.
Instructions
List commit history for a project or specific branch/tag. Filter by date range (since/until), file path, author, and paginate results. Returns commit SHA, message, author, timestamp, and stats.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination (integer, ≥1, default: 1) | |
| path | No | Filter commits affecting this file path (string). Shows only commits that modified this file. Example: 'src/main.py' | |
| per_page | No | Number of results per page (integer, 1-100, default: 20) | |
| project_id | No | Project ID (integer) or path (string like 'group/project'). Optional - auto-detects from current git repository if not provided | |
| ref_name | No | Git reference: branch name, tag name, or tag name. Optional - defaults to project's default branch (usually 'main' or 'master') | |
| since | No | Start date for filtering (string, ISO 8601 format). Example: '2024-01-01' or '2024-01-01T00:00:00Z' | |
| until | No | End date for filtering (string, ISO 8601 format). Example: '2024-12-31' or '2024-12-31T23:59:59Z' |