gitlab-super-search 0.4.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

With uv (recommended):

uv tool install gitlab-super-search

Or with pip:

pip install gitlab-super-search

For local development:

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

Prerequisites

Environment variables:

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

Usage

glss \
  --group-path platform/k8s-manifests \
  --search "image: nginx" \
  --preset kubernetes \
  --out nginx_images.xlsx

Running from a checkout still works:

python glss.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.