bubble-agent 0.1.0

Run your coding agent in a bubble.

bubble-agent

This project is inspired by cyunrei/opencode-bwrap.

Run your coding agent in a bubble.

Uses bubblewrap to sandbox coding agents with configurable bind mounts and virtual workspace (.code-workspace) support. Sandbox arguments are passed via --args <fd> for clean process listings, and /etc/profile is automatically patched to prevent login shells from resetting the custom PATH.

By default, the sandbox wraps opencode. Use --bin to run a different coding agent.

Quick Start

git clone https://github.com/ak1ra-lab/bubble-agent.git
cd bubble-agent
just install

bubble-agent                              # runs opencode by default
bubble-agent ~/my-project                 # work in a specific directory
bubble-agent --dry-run                    # preview the bwrap command

See Documentation for full usage, configuration, and workspace features.