Opencode Box

opencode-box

**A secure, containerized development environment for AI-assisted coding with OpenCode**

OpenCode Box provides an isolated Docker environment where you can safely work with AI-powered development tools while keeping your host system secure. It automatically sets up a complete development environment with your project, credentials, and OpenCode configurations.

🚀 Installation

Install OpenCode Box globally via NPM:

npm install -g opencode-box

⚡ Quick Start

1. **Navigate to any Git repository:**

   cd /path/to/your/git/project

2. **Launch OpenCode Box:**

   opencodebox

**That's it!** OpenCode Box will automatically:

• 🐳 Build the Docker image (if not already built)
• 🔐 Securely forward your SSH/Git credentials to the container
• ⚙️ Copy OpenCode configurations (~/.local/share/opencode and ~/.config/opencode)
• 📂 Clone the current repository inside the container
• 🌿 Checkout to the current branch from your host machine
• 🤖 Start OpenCode in the isolated environment

🎛 Workspace Modes

OpenCode Box supports three different workspace modes to suit your needs:

`--gitcheckout` (Default)

**Isolated development environment** - Clones repository inside container

opencodebox --gitcheckout

• ✅ Interactive terminal session
• 🔐 SSH credentials required
• 📦 Dedicated workspace volume
• 🔄 Automatic cleanup on exit

`--mount-ro`

**Read-only workspace mounting** - Direct access to your current files

opencodebox --mount-ro

• 🔍 Code examination only
• 🚫 No file modifications allowed
• ⚡ No SSH requirements
• 📁 Direct workspace mounting

`--mount-rw`

**Read-write workspace mounting** - Edit files directly in your workspace

opencodebox --mount-rw

• ✏️ Direct file editing
• 💾 Changes saved to host filesystem
• ⚡ No SSH requirements
• 📁 Direct workspace mounting

🛠️ Advanced Usage

Container Management

**Interactive Shell Access** Get a