https://github.com/k1lgor/pi-container-dashboard
🐳 A pi coding agent extension for managing Docker, Podman, and Nerdctl containers — list, logs, prune, stats, inspect, and more — right from your AI agent.
https://github.com/k1lgor/pi-container-dashboard
ai-agent container-management containers devops docker nerdctl pi-coding-agent pi-extension podman typescript
Last synced: 3 days ago
JSON representation
🐳 A pi coding agent extension for managing Docker, Podman, and Nerdctl containers — list, logs, prune, stats, inspect, and more — right from your AI agent.
- Host: GitHub
- URL: https://github.com/k1lgor/pi-container-dashboard
- Owner: k1lgor
- License: mit
- Created: 2026-05-04T11:16:38.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-04T11:50:11.000Z (about 2 months ago)
- Last Synced: 2026-05-04T13:31:31.277Z (about 2 months ago)
- Topics: ai-agent, container-management, containers, devops, docker, nerdctl, pi-coding-agent, pi-extension, podman, typescript
- Language: TypeScript
- Size: 45.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🐳 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 ` | 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 ` | Stop a container |
| `/docker:start ` | Start a container |
| `/docker:restart ` | Restart a container |
| `/docker:stats` | Show CPU/memory/network usage |
| `/docker:inspect ` | Show detailed container config |
| `/docker:top ` | Show processes inside a container |
| `/docker:rm ` | 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](https://github.com/mariozechner/pi-coding-agent)
- **Docker** or **Podman** or **Nerdctl** installed and running
---
## 📦 Installation
### From npm (recommended)
```bash
pi install npm:container-dashboard
```
### From GitHub
```bash
pi install git:github.com/k1lgor/pi-container-dashboard
```
### Or load locally
```bash
pi -e ./path/to/index.ts
```
The extension auto-detects `docker` → `podman` → `nerdctl` at startup.
---
## 🚀 Quick Start
```bash
# 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