Developer Tools

Docker Hub

pp-docker-hub

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).

Printed by @hnshah (Hiten Shah)

Install

npx — recommended

npx -y @mvanhorn/printing-press-library install docker-hub

Installs the CLI binary and the agent skill (Claude Code, Codex, Cursor, Gemini CLI, Copilot, and more). Add --cli-only or --skill-only for one half. Requires Node.

Hermes

hermes skills install mvanhorn/printing-press-library/cli-skills/pp-docker-hub --force

From the Hermes CLI. Inside a chat session use /skills install with the same path.

OpenClaw

Install the pp-docker-hub skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-docker-hub. The skill defines how its required CLI can be installed.

Paste this to your OpenClaw agent — the skill describes how to install its CLI.

Claude Desktop

This CLI ships an MCPB bundle. Download the latest release .mcpb and double-click it — Claude Desktop walks you through the install.

View source on GitHub →

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