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
Install with uv:
# From PyPI
uv tool install bubble-agent
# From Test PyPI
uv tool install --index-url https://test.pypi.org/simple/ bubble-agent
# From GitHub (master branch)
uv tool install git+https://github.com/ak1ra-lab/bubble-agent.git
# From GitHub (specific branch or tag)
uv tool install git+https://github.com/ak1ra-lab/bubble-agent.git@dev
uv tool install git+https://github.com/ak1ra-lab/bubble-agent.git@v0.1.0
# From local clone
git clone https://github.com/ak1ra-lab/bubble-agent.git
cd bubble-agent
uv tool install .
Then run:
bubble-agent # runs opencode by default
bubble-agent ~/my-project # work in a specific directory
bubble-agent --dry-run # preview the bwrap command
Set up your configuration:
mkdir -p ~/.config/bubble-agent
curl -o ~/.config/bubble-agent/bubble-agent.conf \
https://raw.githubusercontent.com/ak1ra-lab/bubble-agent/master/bubble-agent.example.conf
# edit ~/.config/bubble-agent/bubble-agent.conf
See Documentation for full usage, configuration, and workspace features.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file bubble_agent-0.2.0.tar.gz.
File metadata
- Download URL: bubble_agent-0.2.0.tar.gz
- Upload date:
- Size: 66.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0462a0a26d78bdbba4a4f9da4fa1c88d8f3fc79db96199e8068798e44a2063e7
|
|
| MD5 |
fdf852e2ebd235303bf471c942e94643
|
|
| BLAKE2b-256 |
9c897eeb93f4b9f98787a962c6c779b9e6c2f331e59f1fd5de8f8183af87b483
|
Provenance
The following attestation bundles were made for bubble_agent-0.2.0.tar.gz:
Publisher:
publish-to-pypi.yaml on ak1ra-lab/bubble-agent
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
bubble_agent-0.2.0.tar.gz -
Subject digest:
0462a0a26d78bdbba4a4f9da4fa1c88d8f3fc79db96199e8068798e44a2063e7 - Sigstore transparency entry: 2113171973
- Sigstore integration time:
-
Permalink:
ak1ra-lab/bubble-agent@ac09c9242eefc8f5efd4d018076f12b84c4cd3b2 -
Branch / Tag:
refs/tags/v0.2.0 - Owner: https://github.com/ak1ra-lab
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-to-pypi.yaml@ac09c9242eefc8f5efd4d018076f12b84c4cd3b2 -
Trigger Event:
push
-
Statement type:
File details
Details for the file bubble_agent-0.2.0-py3-none-any.whl.
File metadata
- Download URL: bubble_agent-0.2.0-py3-none-any.whl
- Upload date:
- Size: 12.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ddede2bee8da69f17b3aa24f6fa6e75b76c832d9d9c19c191159607dbe505803
|
|
| MD5 |
8fa417bdab9432213f51435c7f413d66
|
|
| BLAKE2b-256 |
e7d3d80442fa9d81ff26c74da74f6b8da259f86afd13538bd3e341cb3d40cea3
|
Provenance
The following attestation bundles were made for bubble_agent-0.2.0-py3-none-any.whl:
Publisher:
publish-to-pypi.yaml on ak1ra-lab/bubble-agent
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
bubble_agent-0.2.0-py3-none-any.whl -
Subject digest:
ddede2bee8da69f17b3aa24f6fa6e75b76c832d9d9c19c191159607dbe505803 - Sigstore transparency entry: 2113171989
- Sigstore integration time:
-
Permalink:
ak1ra-lab/bubble-agent@ac09c9242eefc8f5efd4d018076f12b84c4cd3b2 -
Branch / Tag:
refs/tags/v0.2.0 - Owner: https://github.com/ak1ra-lab
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-to-pypi.yaml@ac09c9242eefc8f5efd4d018076f12b84c4cd3b2 -
Trigger Event:
push
-
Statement type:
