GitLab Super Search

Search for patterns across every project in a GitLab group and export matching files to Excel. YAML is searched by default, with presets and custom extension filters available when needed.

Installation

python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt

Prerequisites

Environment variables:

export GITLAB_URL="https://gitlab.com"
export GITLAB_TOKEN="glpat-xxxx"

Usage

python3 gss.py \
  --group-path platform \
  --search "kaniko-project/executor:debug" \
  --out kaniko_old_image.xlsx

Presets

Preset	Extensions
kubernetes	.yaml, .yml, .json
terraform	.tf, .tfvars, .hcl
ci	.yaml, .yml, .json, .toml
containers	.yaml, .yml, .json, Dockerfile

Use presets with --preset <name>.

Custom extensions

• --extensions json,xml : search only the listed extensions.
• --extensions all : search all indexed file types.

--preset and --extensions cannot be used together.