Skip to main content

One CLI for containerized AI coding agents

Project description

VibePod icon

VibePod

Docs PyPI CI Docs Build License

VibePod is a unified CLI (vp) for running AI coding agents in isolated Docker containers — no required configuration, no setup. Just vp run <agent>. 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 <agent> 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 & 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 installpip install vibepod

Installation

VibePod is available on PyPI:

pip install vibepod

Quick Start

vp run <agent>
# 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:

vp run <agent> -- <agent-args>

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
opencode Not supported
auggie Not supported
pi Not supported

VibePod CLI preview

Tool Thumbnails

Claude Code Google Gemini OpenAI Codex GitHub Copilot OpenCode Mistral Vibe Augment Auggie Pi Agent

Current Status

This repository contains an initial v1 implementation with:

  • vp run <agent>
  • vp stop <agent|--all>
  • 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.

VibePod Analytics 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. Source Dockerfiles are in VibePod/vibepod-agents.

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
  • datasette -> vibepod/datasette:latest
  • proxy -> vibepod/proxy:latest (repo)

Overriding Images

You can override any single image directly:

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_DATASETTE_IMAGE=vibepod/datasette:latest vp logs start
VP_SKILLS_ENGINE_IMAGE=vibepod/skills-engine:latest vp skills list

License

MIT License - see LICENSE for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vibepod-0.13.0.tar.gz (975.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vibepod-0.13.0-py3-none-any.whl (43.3 kB view details)

Uploaded Python 3

File details

Details for the file vibepod-0.13.0.tar.gz.

File metadata

  • Download URL: vibepod-0.13.0.tar.gz
  • Upload date:
  • Size: 975.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for vibepod-0.13.0.tar.gz
Algorithm Hash digest
SHA256 4baf6c72309d62e406b044536d4926be597e9fe39b3ec8a1156a8b0515f0d174
MD5 70508d210e4c9d89676fb545513058e5
BLAKE2b-256 09ef30b6695047e267ba9779bdfacaacc1bbf5a341aaa89fbce18fc2b3884901

See more details on using hashes here.

File details

Details for the file vibepod-0.13.0-py3-none-any.whl.

File metadata

  • Download URL: vibepod-0.13.0-py3-none-any.whl
  • Upload date:
  • Size: 43.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for vibepod-0.13.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ac718d0bd3c7432be9936d4f05d8c298aee4ef17276af8fb241a38f3222c17dd
MD5 907074892503ba7e729fc5e9e393a5df
BLAKE2b-256 3dd08220ba3cdc7ef74b7b0f6c8a4da53bb204b54a8e4d32fefd5ffef465a7b3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page