Visualize GitLab CI/CD pipeline YAML files locally, without pushing your changes.
⚠️ Disclaimer: This is an independent, community-developed VS Code extension and is not affiliated with, endorsed by, or officially supported by GitLab Inc. For production pipelines, always validate using the official GitLab CI/CD system.
Installation
Launch VS Code.
Quick Open (Ctrl+P).
Paste the command ext install sergiogarciiam.pipeline-mapper and press enter.
Quick Usage
Open a .yml or .yaml file in VS Code.
Open the Command Palette: Ctrl + Shift + P or Cmd + Shift + P.
Run: Generate Pipeline Mapper.
Works only with valid GitLab CI/CD YAML files.
Features
Automatic stage mapping for visual representation of jobs by stage.
Show basic information about jobs.
Show dependencies of jobs (individually or all).
Automatic dependency grouping (needGroup) for visual mapping.
Recursive include support with cycle detection.
Recursive extends resolution with inheritance merging.
needs resolution with cycle and post-stage validation.
Apply rules (if, exists, and changes supporting || logical OR) to see how the pipeline flow changes.
Detailed error handling for invalid YAML, missing includes, extends, or needs.
Hidden job filtering (jobs starting with . are ignored).
Known Issues
YAML anchors (&, *) are not supported.
Remote includes (include: remote:) are not supported.
Jobs with optional dependencies may appear as errors.
rules with logical AND (&&), negation (!), or parentheses are not supported.
Try the Code
If you’d like to run or modify the extension locally:
Run code
Clone this repository.
Install dependencies: npm install.
Start debugging in VS Code (F5) → a new Extension Development Host will open.
Open a .yml file and run Generate Pipeline Mapper from the Command Palette.
Make changes
Frontend changes: Rerun Generate Pipeline Mapper.
Backend changes: Press Ctrl + R in the Extension Host to reload.
