compose_top
Show live process lists for services in a Docker Compose project, returning ps-style output per service. Use it to inspect running container processes without shell access.
Instructions
Show the running processes of a compose project's containers.
Output is the ps-style process table per service (not JSON); read it from stdout. The
per-container equivalent is container_top.
Does not raise on a non-zero CLI exit — inspect returncode/stderr in the result.
args:
services - Restrict to these services (default: all)
project_dir - Dir with the compose file (default: server cwd; copied to the target host if no local plugin)
files - Explicit compose file paths (repeatable, -f)
project_name - Compose project name override
returns: dict - {"returncode": int, "stdout": str, "stderr": str, "truncated": bool}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| files | No | ||
| services | No | ||
| project_dir | No | ||
| project_name | No |