# dcps

By

Endkind

●

In 

EnderCliTools

●

Published 2025-09-17

A pretty replacement for docker compose ps that displays Docker Compose services in a nicely formatted table.

The tool can be executed in three different ways:

# Full command
enderclitools dcps [OPTIONS]

# Short alias
ect dcps [OPTIONS]

# Direct alias
dcps [OPTIONS]

• -a, --all - Show all containers (default shows just running)
• -f, --filter <FILTER> - Filter output based on conditions provided
• --no-orphans - Exclude orphaned services (not declared by project)
• --status <STATUS> - Filter services by status:
  • paused - Show only paused containers
  • restarting - Show only restarting containers
  • removing - Show only containers being removed
  • running - Show only running containers
  • dead - Show only dead containers
  • created - Show only created containers
  • exited - Show only exited containers

• --no-trunc - Don't truncate output
• -q, --quiet - Only display container IDs
• --services - Display services

• --table-preset <TABLE_PRESET> - Predefined table styles:

  • ascii-full - Full ASCII borders
  • ascii-full-condensed - Condensed ASCII borders
  • ascii-no-borders - No borders
  • ascii-borders-only - Only outer borders
  • ascii-borders-only-condensed - Condensed outer borders
  • ascii-horizontal-only - Only horizontal lines
  • ascii-markdown - Markdown table style
  • utf8-full - Full UTF8 borders
  • utf8-full-condensed - Condensed UTF8 borders
  • utf8-no-borders - No UTF8 borders
  • utf8-borders-only - Only UTF8 outer borders
  • utf8-horizontal-only - Only UTF8 horizontal lines
  • nothing - No formatting

• --table-modifier <TABLE_MODIFIER> - Additional table modifiers:

  • utf8-round-corners - Rounded corners
  • utf8-solid-inner-borders - Solid inner borders

• --headers <HEADERS> - Determines which columns are displayed:

  • id - Container ID
  • service - Service name
  • names - Container names
  • image - Docker image
  • status - Container status
  • ports - Port mappings
  • command - Executed command
  • created-at - Creation timestamp
  • created - Creation time (relative)
  • size - Container size
  • labels - Container labels
  • mounts - Volume mounts

• --add-headers <ADD_HEADERS> - Adds additional columns to the default columns (same options as --headers)

• -h, --help - Print help

# Basic usage - show running compose services
PS C:\Users\endki\laravel_example> dcps
╭───────────┬───────────────────────────┬───────────────────┬─────────────────────────────────────╮
│ Service   ┆ Image                     ┆ Status            ┆ Ports                               │
╞═══════════╪═══════════════════════════╪═══════════════════╪═════════════════════════════════════╡
│ db        ┆ postgres:latest           ┆ Up About a minute ┆ 5432/tcp                            │
├╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ queue     ┆ laravel_example-queue     ┆ Up About a minute ┆ 9000/tcp                            │
├╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ redis     ┆ redis:latest              ┆ Up About a minute ┆ 6379/tcp                            │
├╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ scheduler ┆ laravel_example-scheduler ┆ Up About a minute ┆ 9000/tcp                            │
├╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ web       ┆ laravel_example-web       ┆ Up About a minute ┆ 0.0.0.0:80->80/tcp, [::]:80->80/tcp │
╰───────────┴───────────────────────────┴───────────────────┴─────────────────────────────────────╯

# Show all containers including stopped ones
dcps -a

# Show only running services
dcps --status running

# Show only service names
dcps --services

# Filter by specific status
dcps --status exited

# Show specific columns
dcps --headers service,names,status,ports

# Exclude orphaned containers
dcps --no-orphans