Docker Hub CLI

Docker Hub public API. Search container images, browse tags, check sizes, inspect Dockerfiles, and explore the world's largest container registry. No authentication required for public repositories (rate limited to ~18 req/min).

Created by @hnshah (Hiten Shah).

Quick Start

1. Install

See Install above.

2. Verify Setup

docker-hub-pp-cli doctor

This checks your configuration.

3. Try Your First Command

docker-hub-pp-cli docker-hub-search

Usage

Run docker-hub-pp-cli --help for the full command reference and flag list.

Commands

docker-hub-search

Manage docker hub search

• docker-hub-pp-cli docker-hub-search search-repositories - Full-text search across all Docker Hub repositories. Returns name, description, stars, and pull counts.

repositories

Repository metadata and details

• docker-hub-pp-cli repositories get-repository - Full metadata for a Docker Hub repository including pull count, stars, description, and last update time.

Output Formats

# Human-readable table (default in terminal, JSON when piped)
docker-hub-pp-cli docker-hub-search

# JSON for scripting and agents
docker-hub-pp-cli docker-hub-search --json

# Filter to specific fields
docker-hub-pp-cli docker-hub-search --json --select id,name,status

# Dry run — show the request without sending
docker-hub-pp-cli docker-hub-search --dry-run

# Agent mode — JSON + compact + no prompts in one flag
docker-hub-pp-cli docker-hub-search --agent

Agent Usage

This CLI is designed for AI agent consumption:

• Non-interactive - never prompts, every input is a flag
• Pipeable - --json output to stdout, errors to stderr
• Filterable - --select id,name returns only fields you need
• Previewable - --dry-run shows the request without sending
• Read-only by default - this CLI does not create, update, delete, publish, send, or mutate remote resources
• Offline-friendly - sync/search commands can use the local SQLite store when available
• Agent-safe by default - no colors or formatting unless --human-friendly is set

Exit codes: 0 success, 2 usage error, 3 not found, 5 API error, 7 rate limited, 10 config error.

Health Check

docker-hub-pp-cli doctor

Verifies configuration and connectivity to the API.

Configuration

Config file: ~/.config/docker-hub-pp-cli/config.toml

Troubleshooting

Not found errors (exit code 3)

• Check the resource ID is correct
• Run the list command to see available items

---

Generated by CLI Printing Press