Show HN：vibebox - 本地AI代理的Docker沙箱替代方案

Security Update: Classic tokens have been revoked. Granular tokens are now limited to 90 days and require 2FA by default. Update your CI/CD workflows to avoid disruption. Learn more.

vibebox

vibebox

A minimal CLI for running dev sandboxes and CLI agents in Docker containers.

Each workspace gets its own isolated container with automatic credential sync and config isolation. The architecture supports multiple agents. Currently only Claude Code is integrated.

Also good to protect your butt from npm supply chain attacks.

Why vibebox instead of docker sandbox, raw docker, or devcontainers?

Requirements

Install

Add to your shell profile (optional):

Usage

Temporary Workspaces

Creates a workspace in your system's temp directory. On exit, prompts to save or delete:

Port Management

Default ports exposed: 5173, 3000, 3001, 4173, 8080 (dynamic host allocation)

When a service starts listening inside the container, you'll see:

For unmapped ports:

Image Build

The Docker image matches your host environment. vibebox rebuild detects your Node.js/npm versions and user info (UID, GID, home path), ensuring seamless file permissions.

Version Management

When agent versions differ between host and sandbox:

Git & SSH Integration (experimental)

Git config is automatically synced from host (user.name, user.email, aliases, common settings).

SSH agent forwarding: If $SSH_AUTH_SOCK exists, it's mounted into the container. Your SSH keys work without copying them.

GitHub CLI: If ~/.config/gh/hosts.yml exists, it's mounted into the container and gh auth setup-git runs automatically.

HTTPS hint: If using HTTPS remotes with SSH available, you'll see:

Customization (experimental)

Setup scripts run once when a container is first created:

Custom Dockerfiles extend the base image:

Image hierarchy: vibebox → vibebox:user (global) → vibebox:<hash> (local)

Run vibebox rebuild after editing Dockerfiles.

Why vibebox?

vs docker sandbox

Docker Desktop includes an experimental docker sandbox command for running agents (Claude Code, Gemini) in containers. Here's why vibebox takes a different approach:

vs raw docker

vs devcontainers

License

AGPL-3.0-or-later

Readme

Keywords

Package Sidebar

Install

npm i vibebox

DownloadsWeekly Downloads

95

Version

0.0.2

License

SEE LICENSE IN LICENSE.md

Unpacked Size

108 kB

Total Files

14

Last publish

7 minutes ago

Collaborators

Footer

Support

Company

Terms & Policies