VibePod
VibePod is a unified CLI (`vp`) for running AI coding agents in isolated
Docker containers — no required configuration, no setup. Just
`vp run `. Includes built-in local metrics collection, HTTP traffic
tracking, and an analytics dashboard to monitor and compare agents side-by-side.
## Features
- ⚡ **Zero config** — no setup required; `vp run ` just works. Optional YAML for custom configuration
- 🐳 **Isolated agents** — each agent runs in its own Docker container
- 🔀 **Unified interface** — one CLI for Claude, Gemini, Codex, Devstral/Vibe, Copilot, Auggie, Pi, Agy & more
- 🧩 **Skills** — install reusable prompt recipes per-project or per-user with `vp skills add`
- 📊 **Local analytics dashboard** — track usage and HTTP traffic per agent, plus token metrics
- ⚖️ **Agent comparison** — benchmark multiple agents against each other in the dashboard
- 🔒 **Privacy-first** — all metrics collected and stored locally, never sent to the cloud
- 📦 **Simple install** — `pip install vibepod`
## Installation
VibePod is available on [PyPI](https://pypi.org/project/vibepod/):
```bash
pip install vibepod
```
## Quick Start
```bash
vp run
# examples:
vp run claude
vp run codex
vp run vibe # alias of devstral
```
Extra arguments after the agent are forwarded to the agent process. Use `--`
before agent flags so VibePod does not parse them as its own options:
```bash
vp run --
```
## IKWID Mode (`--ikwid`)
Use `--ikwid` to append each agent's auto-approval / permission-skip flag when supported.
| Agent | `--ikwid` appended args |
|---|---|
| `claude` | `--dangerously-skip-permissions` |
| `gemini` | `--approval-mode=yolo` |
| `devstral` (`vibe`) | `--auto-approve` |
| `copilot` | `--yolo` |
| `codex` | `--dangerously-bypass-approvals-and-sandbox` |
| `pi` | `--approve` |
| `agy` | `--dangerously-skip-permissions` |
| `opencode` | Not supported |
| `auggie` | Not supported |
## Tool Thumbnails
## Current Status
This repository contains an initial v1 implementation with:
- `vp run `
- `vp stop `
- `vp list`
- `vp config init`
- `vp config show`
- `vp config path`
- `vp version`
## Analytics & Dashboard
VibePod collects metrics locally while your agents run and serves them through
a built-in dashboard.
| Command | Description |
|------------------|----------------------------------------------------|
| `vp logs start` | Start or resume dashboard for collected metrics |
| `vp logs stop` | Stop the dashboard container |
| `vp logs status` | Show dashboard container status |
The dashboard shows per-agent HTTP traffic, usage over time, and Claude token
metrics. It also lets you compare agents side-by-side. All data stays on your
machine.
## Image Namespace
All agent images are published under the [`vibepod` namespace on Docker Hub](https://hub.docker.com/u/vibepod). Source Dockerfiles are in [VibePod/vibepod-agents](https://github.com/VibePod/vibepod-agents/tree/main/docker).
Current defaults:
- `claude` -> `vibepod/claude:latest`
- `gemini` -> `vibepod/gemini:latest`
- `opencode` -> `vibepod/opencode:latest`
- `devstral` (alias: `vibe`) -> `vibepod/devstral:latest`
- `auggie` -> `vibepod/auggie:latest`
- `copilot` -> `vibepod/copilot:latest`
- `codex` -> `vibepod/codex:latest`
- `pi` -> `vibepod/pi:latest`
- `agy` -> `vibepod/agy:latest`
- `datasette` -> `vibepod/datasette:latest`
- `proxy` -> `vibepod/proxy:latest` ([repo](https://github.com/VibePod/vibepod-proxy))
## Overriding Images
You can override any single image directly:
```bash
VP_IMAGE_CLAUDE=vibepod/claude:latest vp run claude
VP_IMAGE_GEMINI=vibepod/gemini:latest vp run gemini
VP_IMAGE_OPENCODE=vibepod/opencode:latest vp run opencode
VP_IMAGE_DEVSTRAL=vibepod/devstral:latest vp run devstral
VP_IMAGE_DEVSTRAL=vibepod/devstral:latest vp run vibe # same agent/image as devstral
VP_IMAGE_AUGGIE=vibepod/auggie:latest vp run auggie
VP_IMAGE_COPILOT=vibepod/copilot:latest vp run copilot
VP_IMAGE_CODEX=vibepod/codex:latest vp run codex
VP_IMAGE_PI=vibepod/pi:latest vp run pi
VP_IMAGE_AGY=vibepod/agy:latest vp run agy
VP_DATASETTE_IMAGE=vibepod/datasette:latest vp logs start
VP_SKILLS_ENGINE_IMAGE=vibepod/skills-engine:latest vp skills list
```
## License
MIT License - see [LICENSE](LICENSE) for details.