docker-list

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Security

Grade A, and why

docker-list scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

plugin/commands/docker-list.md · 40 lines

What it actually says

set -euo pipefail
source "${CLAUDE_PLUGIN_ROOT:-plugin}/commands/_compose-lib.sh"

ALL=0; SERVER_ARG=""
set -f            # no globbing of unquoted $ARGUMENTS (review H2)
# shellcheck disable=SC2086  # intentional: iterate ARGUMENTS as words
for a in ${ARGUMENTS:-}; do
  case "$a" in
    --all) ALL=1 ;;
    --*) echo "Unknown flag: $a" >&2; exit 1 ;;
    *) SERVER_ARG="$a" ;;
  esac
done

NAME="$(resolve_server "$SERVER_ARG")"
build_ssh "$NAME"; echo_target "$NAME"
resolve_docker_cmd "$NAME"; docker_precheck

FMT='{{.Names}}\t{{.Image}}\t{{.Status}}\t{{.Label "com.docker.compose.project"}}'
if [ "$ALL" -eq 1 ]; then PS_ARGS="ps --all"; else PS_ARGS="ps"; fi
if RAW="$("${FM_SSH[@]}" "$FM_DOCKER $PS_ARGS --format '$FMT'" 2>/dev/null)"; then :; else
  echo "ERROR: 'docker ps' failed on $NAME (daemon down or permission?)." >&2; exit 1
fi
[ -z "$RAW" ] && { echo "No containers (running)."; exit 0; }

printf "%-24s %-34s %-16s %s\n" "NAME" "IMAGE" "STATUS" "PROJECT"
echo "$RAW" | while IFS=$'\t' read -r n img st proj; do
  printf "%-24s %-34s %-16s %s\n" "$n" "$img" "$st" "${proj:-(standalone)}"
done

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

Related

Other commands, from other repositories