Skip to content

GitLab

Monitor merge requests, pipeline failures, and issue assignments across your GitLab projects. Works with both gitlab.com and self-hosted instances.

Quick Setup

  1. Go to gitlab.com/-/user_settings/personal_access_tokens
  2. Click Add new token
  3. Name it "Phyllax", set an expiration date, and select the scopes: api, read_api
  4. Click Create personal access token and copy the token (starts with glpat-)
  5. In Phyllax → Integrations → GitLab → Connect → paste the token
  6. If you use a self-hosted GitLab, enter your GitLab URL (e.g. https://gitlab.yourcompany.com/api/v4)

Required Credentials

FieldWhere to find it
Personal Access Tokengitlab.com → User Settings → Access Tokens → Create token with api, read_api scopes (glpat-...)
GitLab URL (optional)Leave blank for gitlab.com. Change if you use a self-hosted GitLab instance.

What Phyllax Monitors

ScheduleWhat it checks
MRs needing reviewMerge requests assigned to you or requesting your review
Pipeline failuresFailed CI/CD pipelines on your projects
New issues assignedNew issues assigned to you
Stale merge requestsMerge requests open more than 3 days without activity

Notification Actions

When GitLab finds something important, the notification card shows:

  • View issue / View MR — open in your browser
  • Add comment — AI drafts a comment you can edit before posting
  • Assign to me — assign the item to yourself
  • Escalate — flag the item for attention
  • Mark complete — close the issue or merge the MR

All action chips that involve writing (Add comment, Escalate, etc.) open the AI draft panel — AI generates a suggested response that you can edit before posting.

Troubleshooting

"401 Unauthorized" error

Your personal access token is invalid or expired. Generate a new one at gitlab.com → User Settings → Access Tokens.

Self-hosted GitLab not connecting

Make sure the GitLab URL field includes /api/v4 at the end (e.g. https://gitlab.yourcompany.com/api/v4). Also verify your instance allows API access.

Can't see certain projects

Your token needs the api scope for full access. If you only have read_api, you can read but not write. Make sure the token user has access to the projects you want to monitor.

Phyllax — a local desktop sentinel for your work tools