gitlab-super-search 0.3.1

Search code patterns across GitLab groups and export audit results.

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

Recommended:

uv tool install .

Or with pipx:

pipx install .

For local development:

python3 -m venv .venv
. .venv/bin/activate
python3 -m pip install -e .

Prerequisites

Environment variables:

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

Usage

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

Running from a checkout still works:

python3 gss.py --help

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.