GitLab Workflow
Operate on GitLab repositories using the glab CLI — merge requests, CI/CD pipelines, issues, and releases.
FIRST: Verify Environment
Run both checks before any glab command. If either fails, STOP.
git remote -v | grep -i gitlab
glab auth status
If glab is not installed, ask the user to install it (brew install glab on macOS, sudo apt install glab on Debian/Ubuntu). If not authenticated, run glab auth login. For self-managed instances, use glab auth login --hostname gitlab.example.com.
Critical Rules
- Avoid interactive commands.
glab ci view launches a TUI the agent cannot operate. Use glab ci status for pipeline state and glab ci view --web to open in browser. Always pass --fill --yes to glab mr create to skip interactive prompts.
- Check CI before requesting review. Run
glab ci status after pushing. A broken pipeline wastes reviewer time and signals the MR isn't ready.
- Pull logs first on CI failure. Run
glab ci trace <job-name> before anything else — 90% of failures are self-explanatory from the logs.
Behavioral Guidelines
- Use draft MRs for work in progress: create with
--draft, mark ready with glab mr update <id> --ready
- Reference issues explicitly:
Closes #123 for auto-close, Relates to #123 for tracking only
- Retry flaky failures, fix real ones:
glab ci retry <job-name> once. If it fails again, it's a real issue — read the logs and fix the code.
Quick Reference: MR Commands
| Task |
Command |
| Create MR (non-interactive) |
glab mr create --fill --yes -b main |
| Create draft MR |
glab mr create --fill --yes --draft -b main |
| List open MRs |
glab mr list |
| View MR details |
glab mr view 123 |
| View MR comments |
glab mr view 123 --comments |
| View MR diff |
glab mr diff 123 |
| Check out MR locally |
glab mr checkout 123 |
| Mark draft as ready |
glab mr update 123 --ready |
| Add reviewers |
glab mr update 123 --reviewer user1,user2 |
| Approve MR |
glab mr approve 123 |
| Squash and merge |
glab mr merge 123 --squash |
| Merge without waiting for CI |
glab mr merge 123 --auto-merge=false |
| Add MR comment |
glab mr note 123 -m "message" |
Quick Reference: CI Commands
| Task |
Command |
| Check pipeline status |
glab ci status |
| Watch pipeline live |
glab ci status --live |
| Open pipeline in browser |
glab ci view --web |
| List recent pipelines |
glab ci list |
| Pull job logs |
glab ci trace <job-name> |
| Retry failed job |
glab ci retry <job-name> |
| Run new pipeline |
glab ci run |
| Run with variables |
glab ci run --variables "KEY:value" |
| Download artifacts |
glab job artifact <ref> <job-name> |
Workflow: Branch to Merged MR
After branching, committing, and pushing:
glab mr create --fill --yes -b main # create MR
glab ci status --live # watch pipeline
# if CI fails:
glab ci trace <failed-job-name> # pull logs, fix, push
glab ci status --live # verify fix
# when CI passes and MR is approved:
glab mr merge --squash --remove-source-branch
CI Failure Remediation
glab ci status — identify which pipeline failedglab ci trace <job-name> — pull the failed job's logs- Read the logs from the bottom up — the final error is usually the root cause
- Reproduce locally if possible (run the same commands from
.gitlab-ci.yml)
- Fix, commit, push
glab ci status --live — watch the new pipeline- If still failing, repeat from step 2
Common CI Log Signatures
| Pattern |
Log Signature |
| Test failure |
FAIL, AssertionError, expected ... got |
| Build failure |
compilation failed, cannot find module |
| Timeout |
Job timed out, exceeded limit |
| Missing env/secret |
undefined, authentication failed |
| Dependency issue |
404 Not Found, version not found |
For operations not covered by glab subcommands, use glab api directly. For detailed command options, issue management, releases, search, and advanced CI debugging, see references/commands.md.
Use --fill --yes for MR creation and glab ci status instead of glab ci view — interactive TUI commands will hang.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: gitlab-23description: Manages GitLab merge requests, CI/CD pipelines, and issues via glab CLI. Load before running glab commands, creating MRs, debugging pipeline failures, checking CI status, or any GitLab operation. Triggers on "merge request", "pipeline", "CI failure", "glab", or when git remote contains "gitlab".4---56# GitLab Workflow78Operate on GitLab repositories using the `glab` CLI — merge requests, CI/CD pipelines, issues, and releases.910## FIRST: Verify Environment1112Run both checks before any `glab` command. If either fails, STOP.1314```bash15git remote -v | grep -i gitlab16glab auth status17```1819If `glab` is not installed, ask the user to install it (`brew install glab` on macOS, `sudo apt install glab` on Debian/Ubuntu). If not authenticated, run `glab auth login`. For self-managed instances, use `glab auth login --hostname gitlab.example.com`.2021## Critical Rules2223- **Avoid interactive commands.** `glab ci view` launches a TUI the agent cannot operate. Use `glab ci status` for pipeline state and `glab ci view --web` to open in browser. Always pass `--fill --yes` to `glab mr create` to skip interactive prompts.24- **Check CI before requesting review.** Run `glab ci status` after pushing. A broken pipeline wastes reviewer time and signals the MR isn't ready.25- **Pull logs first on CI failure.** Run `glab ci trace <job-name>` before anything else — 90% of failures are self-explanatory from the logs.2627## Behavioral Guidelines2829- Use draft MRs for work in progress: create with `--draft`, mark ready with `glab mr update <id> --ready`30- Reference issues explicitly: `Closes #123` for auto-close, `Relates to #123` for tracking only31- Retry flaky failures, fix real ones: `glab ci retry <job-name>` once. If it fails again, it's a real issue — read the logs and fix the code.3233## Quick Reference: MR Commands3435| Task | Command |36|------|---------|37| Create MR (non-interactive) | `glab mr create --fill --yes -b main` |38| Create draft MR | `glab mr create --fill --yes --draft -b main` |39| List open MRs | `glab mr list` |40| View MR details | `glab mr view 123` |41| View MR comments | `glab mr view 123 --comments` |42| View MR diff | `glab mr diff 123` |43| Check out MR locally | `glab mr checkout 123` |44| Mark draft as ready | `glab mr update 123 --ready` |45| Add reviewers | `glab mr update 123 --reviewer user1,user2` |46| Approve MR | `glab mr approve 123` |47| Squash and merge | `glab mr merge 123 --squash` |48| Merge without waiting for CI | `glab mr merge 123 --auto-merge=false` |49| Add MR comment | `glab mr note 123 -m "message"` |5051## Quick Reference: CI Commands5253| Task | Command |54|------|---------|55| Check pipeline status | `glab ci status` |56| Watch pipeline live | `glab ci status --live` |57| Open pipeline in browser | `glab ci view --web` |58| List recent pipelines | `glab ci list` |59| Pull job logs | `glab ci trace <job-name>` |60| Retry failed job | `glab ci retry <job-name>` |61| Run new pipeline | `glab ci run` |62| Run with variables | `glab ci run --variables "KEY:value"` |63| Download artifacts | `glab job artifact <ref> <job-name>` |6465## Workflow: Branch to Merged MR6667After branching, committing, and pushing:6869```bash70glab mr create --fill --yes -b main # create MR71glab ci status --live # watch pipeline72# if CI fails:73glab ci trace <failed-job-name> # pull logs, fix, push74glab ci status --live # verify fix75# when CI passes and MR is approved:76glab mr merge --squash --remove-source-branch77```7879## CI Failure Remediation80811. `glab ci status` — identify which pipeline failed822. `glab ci trace <job-name>` — pull the failed job's logs833. Read the logs from the bottom up — the final error is usually the root cause844. Reproduce locally if possible (run the same commands from `.gitlab-ci.yml`)855. Fix, commit, push866. `glab ci status --live` — watch the new pipeline877. If still failing, repeat from step 28889### Common CI Log Signatures9091| Pattern | Log Signature |92|---------|---------------|93| Test failure | `FAIL`, `AssertionError`, `expected ... got` |94| Build failure | `compilation failed`, `cannot find module` |95| Timeout | `Job timed out`, `exceeded limit` |96| Missing env/secret | `undefined`, `authentication failed` |97| Dependency issue | `404 Not Found`, `version not found` |9899For operations not covered by glab subcommands, use `glab api` directly. For detailed command options, issue management, releases, search, and advanced CI debugging, see [references/commands.md](references/commands.md).100101Use `--fill --yes` for MR creation and `glab ci status` instead of `glab ci view` — interactive TUI commands will hang.102103---104> Converted and distributed by [TomeVault](https://tomevault.io/claim/elithrar) — claim your Tome and manage your conversions.105<!-- tomevault:4.0:skill_md:2026-04-11 -->
tomevault-io