{"id":51526635,"url":"https://github.com/ak1ra-lab/bubble-agent","last_synced_at":"2026-07-08T22:01:10.279Z","repository":{"id":367101013,"uuid":"1278622994","full_name":"ak1ra-lab/bubble-agent","owner":"ak1ra-lab","description":"Run your coding agent in a bubble.","archived":false,"fork":false,"pushed_at":"2026-07-08T07:40:46.000Z","size":112,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-07-08T09:15:07.152Z","etag":null,"topics":["agent","agentic","bubblewrap","bwrap","claude-code","codex","opencode","sandbox"],"latest_commit_sha":null,"homepage":"https://ak1ra-lab.github.io/bubble-agent/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ak1ra-lab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-06-24T01:07:05.000Z","updated_at":"2026-07-08T07:40:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ak1ra-lab/bubble-agent","commit_stats":null,"previous_names":["ak1ra-lab/bubble-agent"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ak1ra-lab/bubble-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ak1ra-lab%2Fbubble-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ak1ra-lab%2Fbubble-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ak1ra-lab%2Fbubble-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ak1ra-lab%2Fbubble-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ak1ra-lab","download_url":"https://codeload.github.com/ak1ra-lab/bubble-agent/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ak1ra-lab%2Fbubble-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35279442,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-08T02:00:06.796Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","agentic","bubblewrap","bwrap","claude-code","codex","opencode","sandbox"],"created_at":"2026-07-08T22:01:09.570Z","updated_at":"2026-07-08T22:01:10.270Z","avatar_url":"https://github.com/ak1ra-lab.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bubble-agent\n\n[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/ak1ra-lab/bubble-agent/.github%2Fworkflows%2Fpublish-to-pypi.yaml)](https://github.com/ak1ra-lab/bubble-agent/actions/workflows/publish-to-pypi.yaml)\n[![PyPI - Version](https://img.shields.io/pypi/v/bubble-agent)](https://pypi.org/project/bubble-agent/)\n[![PyPI - Version](https://img.shields.io/pypi/v/bubble-agent?label=test-pypi\u0026pypiBaseUrl=https%3A%2F%2Ftest.pypi.org)](https://test.pypi.org/project/bubble-agent/)\n[![Docs](https://img.shields.io/badge/docs-online-0a7ea4)](https://ak1ra-lab.github.io/bubble-agent/)\n\n\u003e This project is inspired by [cyunrei/opencode-bwrap](https://github.com/cyunrei/opencode-bwrap).\n\nRun your coding agent in a bubble.\n\nUses [bubblewrap](https://github.com/containers/bubblewrap) to sandbox coding agents with configurable bind mounts and virtual workspace (`.code-workspace`) support.  Sandbox arguments are passed via ``--args \u003cfd\u003e`` for clean process listings, and ``/etc/profile`` is automatically patched to prevent login shells from resetting the custom ``PATH``.\n\nBy default, the sandbox wraps [opencode](https://github.com/anomalyco/opencode). Use `--bin` to run a different coding agent.\n\n## Quick Start\n\nInstall with [uv]:\n\n```shell\n# From PyPI\nuv tool install bubble-agent\n\n# From Test PyPI\nuv tool install --index-url https://test.pypi.org/simple/ bubble-agent\n\n# From GitHub (master branch)\nuv tool install git+https://github.com/ak1ra-lab/bubble-agent.git\n\n# From GitHub (specific branch or tag)\nuv tool install git+https://github.com/ak1ra-lab/bubble-agent.git@dev\nuv tool install git+https://github.com/ak1ra-lab/bubble-agent.git@v0.1.0\n\n# From local clone\ngit clone https://github.com/ak1ra-lab/bubble-agent.git\ncd bubble-agent\nuv tool install .\n```\n\nThen run:\n\n```shell\nbubble-agent                              # runs opencode by default\nbubble-agent ~/my-project                 # work in a specific directory\nbubble-agent --dry-run                    # preview the bwrap command\n```\n\nA default [configuration](https://ak1ra-lab.github.io/bubble-agent/configuration/) is\nauto-created at `~/.config/bubble-agent/bubble-agent.conf` on first run — just run\n`bubble-agent` and then edit the file to customize.\n\nSee [Documentation](https://ak1ra-lab.github.io/bubble-agent/) for full usage, configuration, and workspace features.\n\n[uv]: https://docs.astral.sh/uv/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fak1ra-lab%2Fbubble-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fak1ra-lab%2Fbubble-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fak1ra-lab%2Fbubble-agent/lists"}