Install

tokf install ab0836243be7df8c23d538d9069b6799853bd100d1eb1d31969e0149c76efc49

Safety checks passed

Filter definition

command = "docker ps"
run = "docker ps --format json {args}"
passthrough_args = ["--format"]

match_output = [
  { contains = "Cannot connect to the Docker daemon", output = "Docker daemon not running" },
]

[json]

[[json.extract]]
path = "$[*]"
as = "containers"

[[json.extract.fields]]
field = "Names.0"
as = "name"

[[json.extract.fields]]
field = "Image"
as = "image"

[[json.extract.fields]]
field = "Status"
as = "status"

[on_success]
output = "Containers ({containers_count}):\n{containers | each: \"  {name}: {image} ({status})\" | join: \"\\n\"}"

[on_failure]
tail = 10

Examples

daemon not running shows short message ~24 tokens → ~6 tokens (75% saved)

Raw output

Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?

Filtered output

Docker daemon not running

no running containers shows zero count ~0 tokens → ~4 tokens

Raw output

[]

Filtered output

Containers (0):

generic error shows tail ~18 tokens → ~18 tokens

Raw output

Error response from daemon: driver failed programming external connectivity

Filtered output

Error response from daemon: driver failed programming external connectivity

running containers show compact list ~241 tokens → ~45 tokens (81% saved)

Raw output

[
  {
    "Names": ["webserver"],
    "Image": "docker.io/library/nginx:latest",
    "State": "running",
    "Status": "Up 2 hours",
    "Ports": [{"host_port": 80, "container_port": 80, "protocol": "tcp"}],
    "Id": "a1b2c3d4e5f6",
    "Command": ["nginx", "-g", "daemon off;"],
    "Created": "2026-03-06T10:00:00Z"
  },
  {
    "Names": ["db"],
    "Image": "docker.io/library/postgres:16",
    "State": "running",
    "Status": "Up 3 hours",
    "Ports": [{"host_port": 5432, "container_port": 5432, "protocol": "tcp"}],
    "Id": "f6e5d4c3b2a1",
    "Command": ["docker-entrypoint.sh", "postgres"],
    "Created": "2026-03-06T09:00:00Z"
  },
  {
    "Names": ["redis-cache"],
    "Image": "docker.io/library/redis:7-alpine",
    "State": "running",
    "Status": "Up 3 hours",
    "Ports": [{"host_port": 6379, "container_port": 6379, "protocol": "tcp"}],
    "Id": "1a2b3c4d5e6f",
    "Command": ["redis-server"],
    "Created": "2026-03-06T09:00:00Z"
  }
]

Filtered output

Containers (3):
  webserver: docker.io/library/nginx:latest (Up 2 hours)
  db: docker.io/library/postgres:16 (Up 3 hours)
  redis-cache: docker.io/library/redis:7-alpine (Up 3 hours)

Warning: Community filters are third-party code. Review the filter definition above before installing it in production environments.

Browse all filters