Skip to content

Commit b50f038

Browse files
authored
revise README for better clarity and formatting
Updated README to improve clarity and structure of content.
1 parent 649649b commit b50f038

1 file changed

Lines changed: 10 additions & 8 deletions

File tree

README.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,14 @@
1-
<h3 align="center">agent-container</h3>
1+
# Agent Container
22

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.
76
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+
---
812
<p align="center">
913
<a href="#quick-start">Quick Start</a> &middot;
1014
<a href="#why">Why</a> &middot;
@@ -60,7 +64,7 @@ The code inside `workerd` cannot access `fs`, `process`, or `child_process` dire
6064

6165
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.
6266

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.
6468

6569
| Problem | Solution |
6670
|---------|----------|
@@ -111,8 +115,6 @@ Coding agents need to work inside real projects: reading files, writing code, ru
111115
└─────────────────────────────────────────────────────────────────────────────┘
112116
```
113117

114-
**Two runtimes, one boundary:**
115-
116118
- **Host (Node.js)** owns all real authority: filesystem, environment, subprocesses, network policy, observability
117119
- **Guest (workerd)** runs agent code with only the capabilities explicitly granted through bindings
118120

0 commit comments

Comments
 (0)