mcpField
G
glab-container-registry

glab-container-registry

github.com/vince-winkintelCloud & DevOps49103 installsUpdated 1d ago
Repository

About glab-container-registry

A CLI skill for managing GitLab container registry repositories and tags with `glab`. It covers listing, inspection, deletion, and rule-based bulk tag cleanup.

Key features

  1. 01List repositories by project or group
  2. 02View repository details and tags
  3. 03List tags with digest, size, and date
  4. 04Delete repositories and tags
  5. 05Filter bulk cleanup by regex or age

Use cases

  1. 01Inspect registry contents across projects
  2. 02Remove selected repositories or tags
  3. 03Clean up old tags while retaining recent ones

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/vince-winkintel/gitlab-cli-skills --skill glab-container-registry

After installing, type/glab-container-registryin Claude Code to confirm it loaded.

Bundled filesreferences/commands.md

Details

From the project README

glab container-registry

Manage GitLab container registry repositories and tags from the CLI.

Repository IDs come from registry repository list/view output, not from Git repository project IDs.

Common workflows

# List registry repositories for the current project
glab container-registry repository list

# List repositories for another project
glab container-registry repository list -R gitlab-org/cli

# List repositories for a group
glab container-registry repository list --group gitlab-org

# Include tag counts/tags in project repository output
glab container-registry repository list --include-tags-count --include-tags

# JSON output for automation
glab container-registry repository list --output json --jq '.[].id'

Repository commands

# View a registry repository
glab container-registry repository view <repository-id>

# Include tags in the repository response
glab container-registry repository view <repository-id> --include-tags

# Delete a repository and all images/tags published to it (destructive)
glab container-registry repository delete <repository-id>
glab container-registry repository delete <repository-id> --yes

Aliases: repository ls, repository show, and repository del.

Tag commands

# List tags for a registry repository
glab container-registry tag list <repository-id>

# List tags for a repository in another project
glab container-registry tag list <repository-id> -R owner/repo

# Include digest, size, and creation time for each tag
glab container-registry tag list <repository-id> --details

# View a specific tag
glab container-registry tag view <repository-id> <tag-name>

# Delete one tag (destructive)
glab container-registry tag delete <repository-id> <tag-name>
glab container-registry tag delete <repository-id> <tag-name> --yes

Aliases: tag ls, tag show, and tag del.

Bulk tag cleanup

Bulk deletion is scheduled asynchronously by GitLab. Matching tags may remain visible until the background deletion job completes.

# Schedule tags matching a regex for deletion
glab container-registry tag delete <repository-id> \
  --name-regex-delete '^release-.*' \
  --yes

# Delete old tags while keeping the 10 most recent matching tags
glab container-registry tag delete <repository-id> \
  --name-regex-delete '.*' \
  --keep-n 10 \
  --older-than 30d \
  --yes

# Keep tags matching a regex during bulk deletion
glab container-registry tag delete <repository-id> \
  --name-regex-delete '.*' \
  --name-regex-keep '^stable$|^latest$' \
  --yes

Bulk flags:

  • --name-regex-delete <regex> — tag names to delete.
  • --name-regex-keep <regex> — tag names to keep.
  • --keep-n <n> — keep latest N matching tags.
  • --older-than <duration> — delete tags older than durations like 7d or 1month.

Safety notes

  • Treat repository/tag delete commands as destructive; omit --yes unless the target IDs and regexes have been reviewed.
  • Use --output json and --jq for scripts instead of parsing tables.
  • Use -R/--repo whenever running outside the target project's checkout.

Reference

See references/commands.md for command synopsis and flags.

Comments

Markdown supported