🐳 Container Dashboard

A pi coding agent extension for managing Docker and Podman containers without leaving your terminal.

---

✨ Features

📊 TUI Widget

Live container count in pi's sidebar — always know what's running at a glance.

🎯 Commands

Command	What it does
/docker:ps	List containers
/docker:logs <name>	Tail container logs
/docker:prune	Remove stopped containers
/docker:prune --images	Remove unused images
/docker:prune --all	System prune (containers + images)
/docker:images	List pulled images
/docker:stop <name>	Stop a container
/docker:start <name>	Start a container
/docker:restart <name>	Restart a container
/docker:stats	Show CPU/memory/network usage
/docker:inspect <name>	Show detailed container config
/docker:top <name>	Show processes inside a container
/docker:rm <name>	Remove a container or image
/docker:detect	Re-detect the container runtime
/docker:runtime	Show detected runtime info

🤖 LLM Tools

Pi can also manage containers via these tools: container_ps, container_logs, container_prune, container_prune_images, container_prune_system, container_images, container_stop, container_start, container_restart, container_stats, container_inspect, container_top, container_rm

🛡️ Safety

Dangerous commands (rm -f, system prune -a, etc.) are intercepted with a confirmation dialog before execution.

---

🔧 Requirements

• pi v0.70+ — pi coding agent
• Docker or Podman or Nerdctl installed and running

---

📦 Installation

From npm (recommended)

pi install npm:container-dashboard

From GitHub

pi install git:github.com/k1lgor/pi-container-dashboard

Or load locally

pi -e ./path/to/index.ts

The extension auto-detects docker → podman → nerdctl at startup.

---

🚀 Quick Start

# Start pi
pi

# See your containers
/docker:ps

# Check resource usage
/docker:stats

# Clean up
/docker:prune --all

---

🧱 Project Structure

container-dashboard/
├── index.ts       # Entry point, permission gates
├── runtime.ts     # Runtime detection, CLI abstraction
├── commands.ts    # /docker:* commands
├── tools.ts       # LLM tools
├── widget.ts      # TUI widget
├── PLAN.md        # Original design doc
└── README.md      # This file

---

📄 License

MIT