compose_top
Show running processes for each service in a Docker Compose project, returning a ps-style process table. Use it to inspect active container processes.
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 (a missing compose plugin or a timeout still raises) - 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 |