CDD — CLI Docker Dashboard
Interactive terminal dashboard to visualize and manage Docker containers in real time.
What is CDD?
CDD is a keyboard-driven CLI tool that displays all your Docker containers in a clean, auto-refreshing table with live CPU and memory stats for running containers. It's built with React (Ink) and connects directly to your local Docker socket.
Main Features
- 🐳 Clear visualization: See all containers at a glance with status, ports, and resource usage.
- ⌨️ Keyboard shortcuts: Navigate and control containers without leaving the terminal.
- 📊 Live stats: CPU and memory usage refreshed every 2 seconds for running containers.
- 🪵 Real-time logs: Stream container logs directly in the CLI.
- 🎨 Visual interface: Colors and emojis indicate container states (running, stopped, etc.).
- 🚀 Interactive creation: Create new containers with a step-by-step wizard.
Installation
Install CDD globally via npm:
npm install -g cdd-cli
Once installed, launch the dashboard by running:
cdd
What You'll See
When you run cdd, the CLI displays an interactive table listing all containers on your system. The interface auto-refreshes, and you can navigate and control containers using keyboard shortcuts—no command-line arguments needed.
Keyboard Controls
The CLI is fully controlled via keyboard shortcuts. Here's what each key does:
| Key | Action |
|---|---|
↑ / ↓ |
Navigate up/down through the container list |
I |
Start (initiate) the selected container |
P |
Pause (stop) the selected container |
R |
Restart the selected container |
L |
View real-time logs for the selected container (press ESC or Q to exit) |
C |
Create a new container (interactive wizard prompts for image, ports, env vars) |
E |
Erase (remove) the selected container (requires confirmation: Y/N) |
D |
Toggle the on-screen debug log panel (shows internal CLI logs) |
Q |
Quit the CLI |
Use Cases
- Quick container overview: See status, resource usage, and ports for all containers at once.
- Start/stop containers: Control containers without typing
docker start/stopcommands. - Monitor logs in real time: Stream logs directly in the terminal for debugging.
- Rapid prototyping: Create and test containers interactively with the creation wizard.
- DevOps workflows: Integrate CDD into local development to manage microservices or databases.
Requirements
- Node.js ≥ 18
- Docker installed and running (CDD connects to the local Docker socket)
Troubleshooting
If you don't see any containers, ensure Docker is running and your user has permission to access the Docker socket. On Linux, add your user to the docker group or run with sudo.