Pipeline Visualization

glci show renders your pipeline as a terminal-friendly graph showing stages, jobs, and DAG edges.

Usage#

glci show                          # show pipeline graph
glci show --watch                  # re-render on file save
glci show --watch --debounce 500ms # custom debounce interval
glci show --context tag=v1.0.0     # see what runs in a specific context
glci show --input force_build=true # apply pipeline inputs
glci show -p quick                 # visualize a named pipeline preset
glci show --json                   # machine-readable output for scripting

Sample output#

  Pipeline: 5 jobs across 3 stages

  ○ pending  ● running  ✓ passed  ✗ failed  ▶ manual  ⊘ skipped  ⚠ allow_failure

  build       test              deploy
  ─────       ────              ──────
  ○ compile   ○ unit ← compile  ○ staging
              ○ lint            ▶ production
              ○ e2e ← compile

glci show evaluates rules: using the active context (default: merge_request), so the graph only shows jobs that would actually run. See Context Simulation for details.

DAG annotations#

Inline needs: annotations (e.g., unit <- compile) are shown by default. Use --no-dag to replace them with a grouped needs section below the graph.

Both glci show and glci history show support --plain and --no-dag.

Flags#

FlagDescription
-w, --watchWatch for file changes and re-render
--debounceDebounce interval for watch mode (default 300ms)
--plainDisable colors in output
--no-dagMove needs annotations from inline to a section below the graph
--jsonOutput pipeline as JSON
--contextCI context: branch=NAME, merge_request, tag=NAME, env=NAME, or preset name
--mr-sourceSource branch for merge_request context
--mr-targetTarget branch for merge_request context
--input KEY=VALUESet pipeline input (repeatable)
--inputs-fileLoad pipeline inputs from YAML file
-p, --pipelineNamed pipeline preset from .glciconfig.toml
-f, --filePath to CI config file
Esc