Navigate and query self-hosted GitLab instances via REST API. Use when the user asks about GitLab projects, merge requests, issues, pipelines, branches, commits, starred projects, recent activity, code search, container registries, or groups. Triggers on mentions of GitLab, MRs, merge requests, CI/CD pipelines, branches, commits, starred projects, or requests to check what changed in their tracked projects. Supports multiple GitLab instances.
Query self-hosted GitLab instances via REST API v4 using the bundled go run ~/.claude/scripts/gitlab-navigator/main.go CLI wrapper. Credentials are read from ~/.netrc (PRIVATE-TOKEN auth with glpat- PATs). See references/api_endpoints.md for full endpoint reference.
Scan ~/.netrc for GitLab hostnames:
go run ~/.claude/scripts/gitlab-navigator/main.go discover
go run ~/.claude/scripts/gitlab-navigator/main.go discover myorg # custom substring
Test a connection (use hostname or substring):
go run ~/.claude/scripts/gitlab-navigator/main.go acme test
All commands: go run ~/.claude/scripts/gitlab-navigator/main.go <host> <command> [args...]
<host> is a hostname or substring matching a ~/.netrc entry. The script auto-filters for gitlab hosts.
Starred projects (primary watchlist):
go run ~/.claude/scripts/gitlab-navigator/main.go acme starred 25
Starred projects with recent activity:
go run ~/.claude/scripts/gitlab-navigator/main.go acme starred-activity 7
Your recent activity feed:
go run ~/.claude/scripts/gitlab-navigator/main.go acme events 20
Activity on a specific project:
go run ~/.claude/scripts/gitlab-navigator/main.go acme project-events my-group/my-project 20
go run ~/.claude/scripts/gitlab-navigator/main.go acme my-mrs opened 25go run ~/.claude/scripts/gitlab-navigator/main.go acme mr-review opened 25go run ~/.claude/scripts/gitlab-navigator/main.go acme project-mrs my-group/my-project opened 25go run ~/.claude/scripts/gitlab-navigator/main.go acme mr my-group/my-project 42go run ~/.claude/scripts/gitlab-navigator/main.go acme mr-changes my-group/my-project 42go run ~/.claude/scripts/gitlab-navigator/main.go acme my-issues opened 25go run ~/.claude/scripts/gitlab-navigator/main.go acme project-issues my-group/my-project opened 25go run ~/.claude/scripts/gitlab-navigator/main.go acme issue my-group/my-project 10go run ~/.claude/scripts/gitlab-navigator/main.go acme projects 25go run ~/.claude/scripts/gitlab-navigator/main.go acme project-info my-group/my-projectgo run ~/.claude/scripts/gitlab-navigator/main.go acme groups 25go run ~/.claude/scripts/gitlab-navigator/main.go acme group-projects my-group 25go run ~/.claude/scripts/gitlab-navigator/main.go acme pipelines my-group/my-project 15go run ~/.claude/scripts/gitlab-navigator/main.go acme pipeline my-group/my-project 12345go run ~/.claude/scripts/gitlab-navigator/main.go acme branches my-group/my-project 25go run ~/.claude/scripts/gitlab-navigator/main.go acme commits my-group/my-project main 15go run ~/.claude/scripts/gitlab-navigator/main.go acme tree my-group/my-project . maingo run ~/.claude/scripts/gitlab-navigator/main.go acme file my-group/my-project README.md mainGlobal search:
go run ~/.claude/scripts/gitlab-navigator/main.go acme search "rke2" projects
Scopes: projects, issues, merge_requests, milestones, blobs.
Project-scoped search:
go run ~/.claude/scripts/gitlab-navigator/main.go acme project-search my-group/my-project "function_name" blobs
go run ~/.claude/scripts/gitlab-navigator/main.go acme registries my-group/my-projectgo run ~/.claude/scripts/gitlab-navigator/main.go acme whoamigo run ~/.claude/scripts/gitlab-navigator/main.go acme teststarred-activity 7 to see starred projects with recent activitymy-mrs to check merge requests assigned to youmr-review to check MRs awaiting your reviewmy-issues to check your assigned issuesproject-events <project> for detailed activitymr <project> <iid> or issue <project> <iid> for full detailsCategory:other