# regclient/regclient

Docker and OCI Registry Client in Go and tooling using those libraries.

Repository: https://github.com/regclient/regclient
Canonical: https://ross.abutalabs.com/products/regclient
Homepage: https://regclient.org
Language: Go
License: Apache-2.0
License Family: permissive
Topics: docker, registry, hacktoberfest
Last push: 2026-08-24T19:52:26+00:00

## Health v2 (maintenance only)
Score: 90/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 74, longevity 100
- inputs: {"age_days": 2184, "days_push": 9, "days_rel": 99, "gap_med": 42.0, "n_releases_24m": 15}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1918, forks 122 (observed 2026-08-28T04:05:54.886510+00:00)

## What it is
regclient is a Go client library and set of CLI tools (regctl, regsync, regbot) for interacting with Docker and OCI conformant container registries. It supports inspecting, copying, retagging, mutating, and deleting images and OCI artifacts without requiring a container runtime or privileged access.

## Use cases
- copy container images between registries
- list tags in a docker registry
- inspect image manifests without docker
- sync images to a private registry
- delete tags from an OCI registry
- query docker hub rate limits
- mutate image labels and annotations
- work with OCI image layouts locally

## When to choose
- you need to script registry operations without installing Docker or a container runtime
- you want efficient image copying that preserves digests and only pulls required layers
- you need to manage multi-platform images, OCI artifacts, or referrers
- you want to automate registry mirroring or retention policies

## When to avoid
- you need a full container build system like Docker or BuildKit
- you only run containers and never manage registry content directly
- you need a GUI for managing images

## Facets
- artifact type: cli-tool
- maturity: active
- function: http-client, developer-tools, cli, container-runtime, security, api-framework
- domain: developer-tools, cloud-computing, self-hosted
- platform: go, windows, cli, cross-platform
- tags: oci-registry, container-images, docker-registry, oci-artifacts, image-mirroring, oci-image-layout, regctl, regsync, regbot, containers, devops, linux, macos, docker

## Member repositories
- regclient/regclient (main) score 90

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:54.886510+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:10:07.393667+00:00, confidence not recorded.
  - readme: https://github.com/regclient/regclient (fetched 2026-08-28T04:05:54.886510+00:00, sha 933587dd709f)
  - homepage: https://regclient.org (fetched 2026-08-29T10:49:24.013360+00:00, sha f143405d63c5)
  - site_page: https://regclient.org/install (fetched 2026-08-29T10:49:24.022609+00:00, sha 2ca2631d0f3b)
  - site_page: https://regclient.org/usage/faq (fetched 2026-08-29T10:49:24.024692+00:00, sha c2a48a3d7198)
- Data as of 2026-08-30T08:39:29.467469+00:00.