ct

ct lists containers from reslp/dockerfiles and prints ready-to-use Docker or Singularity commands.

Install

Preferred:

uv tool install .
# or
uv tool install git+https://github.com/reslp/ct
ct --help

For local development:

uv sync
uv run ct --help

Metadata

Default source:

https://raw.githubusercontent.com/reslp/dockerfiles/refs/heads/master/ct.yaml

Cached fallback:

~/.ct/cache/ct.yaml

Override the source if needed:

ct --metadata PATH_OR_URL list

The last tag in tags is used as the default tag.

Examples

ct list
ct list --category assembly
ct search blast
ct show spades
ct docker spades
ct d spades
ct singularity spades
ct s spades
ct s --sif reslp/pigz:2.8
ct categories
ct path

With uv run:

uv run ct list

SIF files

Use ct s --sif IMAGE:TAG to pull a Docker image into a SIF file in the current directory:

ct s --sif reslp/pigz:2.8
# runs: singularity pull reslp-pigz-2.8.sif docker://reslp/pigz:2.8
ct s --sif pigz # works when pigz is a known container
# runs: singularity pull reslp-pigz-2.8.sif docker://reslp/pigz:2.8

Clipboard

docker and singularity print one full command per metadata entrypoint, followed by the base command. Only the base command is copied by default. Use --no-copy to disable this.

Supported tools:

• macOS: pbcopy
• Linux: wl-copy, xclip, xsel

Development

uv run --group dev pytest