aibox

Secure, isolated Docker environment for running multiple AI CLIs

Run Claude Code, Codex, and Gemini CLI in a secure container with multi-account support, perfect for developers who work with multiple AI tools.

View on GitHub Get Started
100%
Isolated Environment
YOLO
without the risk
Multi-account
configurations

Why aibox?

Built for developers who need secure, isolated environments for AI development

Multi-CLI Support

Run Claude Code, Codex, and Gemini CLI from a single unified container. Switch between AI tools seamlessly.

Security First

Non-root execution, capability dropping, and complete filesystem isolation. Your host system stays protected.

Multi-Account

Manage separate configurations for work, personal, or client projects. Keep your AI accounts organized.

Git Integration

Seamless git operations with SSH key mounting and macOS compatibility. Your workflow stays intact.

Resource Limited

CPU and memory constraints prevent system exhaustion. Your machine stays responsive.

Simple Management

Single service architecture with docker-compose. No complex configuration needed.

Quick Start

Get up and running with aibox in seconds

1

Install aibox

$ npm install -g @zzev/aibox
2

Navigate to your project

$ cd /path/to/your/project
3

Run aibox

$ aibox

Example Usage

# Interactive shell (default)
$ aibox
# Run Claude Code directly
$ aibox --dangerously-skip-permissions
# Run Codex CLI
$ aibox -t codex
# Run Gemini CLI
$ aibox -t gemini
# YOLO mode (skip all permissions)
$ aibox --yolo

Prerequisites

Docker

Docker and Docker Compose installed and running

Node.js

Node.js 18+ for npm installation

SSH Keys

SSH keys for git operations (optional)

Usage Examples

See how aibox works in practice

Basic Commands

# Interactive shell (default)
$ aibox
# Run specific CLI directly
$ aibox -t codex
$ aibox -t gemini
# YOLO mode (skip permissions)
$ aibox --yolo

Multi-Account Setup

# Configure profiles
$ aibox -p work
$ aibox -p personal
# Use different accounts
$ aibox -a work -t codex
$ aibox -a personal -t claude
# Profiles stored in ~/.aibox/profiles/
work.toml
personal.toml

Update Commands

# Check for Docker image updates
$ aibox --update
# Update specific account
$ aibox -a work --update
# Manual Docker pull
$ docker pull ghcr.io/zzev/aibox:latest

Cleanup Commands

# Clean orphan containers
$ aibox --clean
# List all aibox containers
$ docker ps -a --filter "name=aibox"
# Remove specific container
$ docker rm -f aibox-default

What's Included

Everything you need in one secure environment

Supported CLIs

C
Claude Code
Anthropic's AI coding assistant
C
Codex
OpenAI's code generation tool
G
Gemini
Google's AI assistant

Security Features

Non-root execution (ai user)
Capability dropping
Filesystem isolation
Resource limits (2 CPU, 4GB RAM)
Network isolation
Read-only SSH mounts