Skip to main content

Docker Ps

@sntxrr/docker-psv2026.10.25.1· MIT· 1d agoBEHAVIORSACCEPTED WARNINGS
01README

A read-only container listing of a Docker host over SSH, narrow enough to hand to an unattended triage agent. It answers the first question an alert usually raises -- what is running on that host, and which container holds that port -- with name, image, state, status, published ports and creation time per container. It runs docker ps with an explicit, per-field --format template and rebuilds each row from those fields alone, so no environment variable and no label value ever leaves the host: docker inspect returns every container's environment, which is where compose files keep database passwords and API tokens, and docker ps --format '{{json .}}' includes the Labels field. The type has exactly one method and no free-form command or format argument, so a model instance exposes no write verb at all. Host key checking stays on by default.

02Behaviors1
@sntxrr/docker-ps/hostv2026.10.25.1docker_ps.ts

Global Arguments

ArgumentTypeDescription
sshHoststringDocker host to reach over SSH (hostname, alias or IP).
sshUser?stringSSH user. Needs permission to run `docker ps`, nothing more.
strictHostKeyChecking?enumOpenSSH StrictHostKeyChecking. `no` is never the default.
knownHostsFile?stringOptional UserKnownHostsFile override.
fn ps(all?: boolean)
Read-only. List the host's containers (`docker ps`, explicit fields only): name, image, state, status, published ports, created. No env, no labels. Answers 'who holds port N' via `publishedHostPorts`.
ArgumentTypeDescription
all?booleanInclude stopped containers (`docker ps -a`). Defaults to true: a crashed container is usually the one you are looking for.

Resources

containers(infinite)— Every container on the host with its state and port bindings, sorted by name.
03Previous Versions1
2026.10.22.1MIT
04Stats
A
100 / 100
Downloads
6
Archive size
7.1 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned

06Platforms
07Labels