feat(bottle): opt-in gVisor runtime per bottle
test / run tests/run_tests.py (push) Successful in 19s

Bottles can now set "runtime": "runsc" to launch the agent container
under gVisor instead of runc, adding a userspace syscall barrier
between the agent and the host kernel. Default is runc (Docker
default). Pipelock stays on the default runtime per the research doc's
minimum-diff prescription.

The launcher verifies runsc is registered with the daemon before
launch, surfaces the runtime in the preflight plan, and dies with an
install pointer (and a macOS-not-supported note) when runsc is
requested but unavailable.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
2026-05-10 00:48:11 -04:00
parent 3eff1e0b6e
commit e3f5a5907a
7 changed files with 122 additions and 5 deletions
+23 -5
View File
@@ -31,11 +31,29 @@ more. Any one agent only has the access it needs to do its job.
The container is the boundary against an uncoordinated agent reaching
the host: a misbehaving Claude Code session can't read files outside
the bottle, can't reach the host's network without going through
pipelock, and can't see other bottles. It is not a hardened boundary
against a determined attacker with kernel-level escape capability —
that's a v2 question (see
`docs/research/stronger-isolation-alternatives.md`). The egress proxy
and OAuth-token handling below are the load-bearing pieces of v1.
pipelock, and can't see other bottles. By default it is not a hardened
boundary against a determined attacker with kernel-level escape
capability — see `docs/research/stronger-isolation-alternatives.md`
for the broader v2 discussion.
Linux hosts can opt into [gVisor](https://gvisor.dev/) per bottle for
a userspace syscall barrier between the agent and the host kernel:
```jsonc
{
"bottles": {
"default": { "runtime": "runsc" }
}
}
```
When `runtime` is set to `"runsc"`, claude-bottle verifies the runtime
is registered with Docker before launch and passes `--runtime=runsc`
to the agent container. Default is `"runc"` (Docker's default). gVisor
is not available on macOS.
The egress proxy and OAuth-token handling below are the load-bearing
pieces of v1.
## Quickstart