docs/tools/tools-and-system/list-processes
System Configuration

List System Processes

CLI Tool Name: list_processes

Checks active OS process statuses rapidly via pgrep + lsof. Natively understands 11 well-known infrastructures (Docker, Redis, Postgres, MySQL, MongoDB, Node, Nginx, Python, Uvicorn, Celery, RabbitMQ). Docker gets special handling via `docker info` integration. It fully accepts "port:3000" syntax if custom tracing is needed.

Parameters

ParameterTypeRequiredDescription
servicesstring[]noArray of process names, or `port:XXXX` mapping to query explicitly. If not provided, tests all 11 default infrastructures.

Example output

json
{
  "services": {
    "Docker": { "running": true, "pids": [452], "ports": [] },
    "Node": { "running": true, "pids": [10852], "ports": [3000] }
  }
}

How to use it

example prompt

Is Postgres running on my machine, and what PID is taking up port 3000?