|
1 | | -<h3 align="center">agent-container</h3> |
| 1 | +# Agent Container |
2 | 2 |
|
3 | | -<p align="center"> |
4 | | - Give your agents tiny boxes, powered by <a href="https://github.com/cloudflare/workerd">workerd</a><br /> |
5 | | - Agent Container is a workerd-based sandbox designed to give coding agents isolated execution environments, providing structured bindings (workspace, exec, env) scoped to a single repository rather than the host system. It's ideal for AI coding tools, agent frameworks, and platforms that need to run untrusted code with fine-grained capability control. |
6 | | -</p> |
| 3 | +### Give your agents tiny boxes, powered by [workerd](https://github.com/cloudflare/workerd) |
| 4 | + |
| 5 | +> ⚠️ This project is under active development. APIs may change. |
7 | 6 |
|
| 7 | +Agent Container is a workerd-based sandbox for running untrusted code from AI agents. It exposes structured capability bindings (filesystem, exec, env) scoped to a single repository, rather than giving agents raw access to the host system. |
| 8 | + |
| 9 | +It's useful for coding assistants, autonomous agents, and any platform that needs to run agent-generated code with fine-grained control over what that code can access. |
| 10 | + |
| 11 | +--- |
8 | 12 | <p align="center"> |
9 | 13 | <a href="#quick-start">Quick Start</a> · |
10 | 14 | <a href="#why">Why</a> · |
@@ -60,7 +64,7 @@ The code inside `workerd` cannot access `fs`, `process`, or `child_process` dire |
60 | 64 |
|
61 | 65 | Coding agents need to work inside real projects: reading files, writing code, running scripts, using environment variables. But giving an agent unrestricted access to your machine is dangerous, and dropping it into a fake environment breaks too many real-world workflows. |
62 | 66 |
|
63 | | -**agent-container** solves this by running agent code inside [workerd](https://github.com/cloudflare/workerd) while keeping all real authority in a Node.js host process. The agent gets a natural development experience. You keep control. |
| 67 | +**agent-container** solves this by running agent code inside workerd while keeping all real authority in a Node.js host process. The agent gets a natural development experience. You keep control. |
64 | 68 |
|
65 | 69 | | Problem | Solution | |
66 | 70 | |---------|----------| |
@@ -111,8 +115,6 @@ Coding agents need to work inside real projects: reading files, writing code, ru |
111 | 115 | └─────────────────────────────────────────────────────────────────────────────┘ |
112 | 116 | ``` |
113 | 117 |
|
114 | | -**Two runtimes, one boundary:** |
115 | | - |
116 | 118 | - **Host (Node.js)** owns all real authority: filesystem, environment, subprocesses, network policy, observability |
117 | 119 | - **Guest (workerd)** runs agent code with only the capabilities explicitly granted through bindings |
118 | 120 |
|
|
0 commit comments