/box

Run agents.Set the boundary.

Isolate agent workloads and control commands, files, network access, and MCP calls with policy.

curl -fsSL https://raw.githubusercontent.com/strands-agents/box/refs/heads/main/download.sh | sh

Apple silicon macOS ARM64 Linux

How it works

Two files define the boundary.

box.toml limits what the workload can reach directly. policy.dw decides mediated requests while it runs.

/box.toml

Set direct access.

Choose the agent command, workspace, programs, environment, and readable or writable paths. The operating system applies those limits before the process starts.

[agent.filesystem]
read = ["~/box-tutorial/strands-home"]
write = ["~/box-tutorial/strands-home"]
list = ["~/box-tutorial/my-project"]
Configure Box

/policy.dw

Decide mediated requests.

Permit or forbid commands, file operations, network requests, and MCP calls routed through Box. Requests without a matching permit are refused.

@id("project_read")
permit (principal, action == Box::Action::"fs:read", resource)
when {
  context.input.path == "~/box-tutorial/my-project" ||
  context.input.path like "~/box-tutorial/my-project/*"
};
Write a policy

Box records policy decisions so you can see which rule matched—or why a request was refused.

Get running

Box the agent you already use.

Install Box, start with a working example, then narrow the boundary for your workload.

/install

Install Box.

Run the installer for a supported platform.

/configure

Set the boundary.

Define direct access in box.toml and mediated actions in policy.dw.

/run

Review and refine.

Launch the workload, review refused requests, and add only the permits you intend.

Run an example

See Box around a real agent.

run-claude-code.sh

./box-core/box run --config claude-code/box.toml -- -p \
  "Summarize README.md in one sentence."