# Strands Box

Run agents. Set the boundary.

Strands Box runs agent workloads inside operating-system boundaries and applies policy to mediated commands, file operations, network requests, and MCP calls.

Box supports Apple silicon macOS and ARM64 Linux.

## Two files define the boundary

### `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.

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

### `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.

```text
@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/*"
};
```

[Configure Box](/pr-cms-6147/docs/user-guide/box/reference/configuration/) · [Write a policy](/pr-cms-6147/docs/user-guide/box/reference/policy/) · [Read the decision log](/pr-cms-6147/docs/user-guide/box/guides/write-a-policy/#step-4-read-the-decision-log) · [Security model](/pr-cms-6147/docs/user-guide/box/security/)

## Box the agent you already use

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

### Install

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

### Configure

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

### Run

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

### Run an example

#### Claude Code

Run Claude Code with Box policy and filesystem boundaries.

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

[Open the full guide](/pr-cms-6147/docs/user-guide/box/guides/run-claude-code/)

#### Codex CLI

Run Codex CLI inside a configured Box workspace.

```sh
./box-core/box run --config codex/box.toml -- \
  "Summarize README.md in one sentence."
```

[Open the full guide](/pr-cms-6147/docs/user-guide/box/guides/run-codex-cli/)

#### Strands Agent

Run a Strands agent behind the same OS and policy boundary.

```sh
./box-core/box run --config strands-agent/box.toml -- \
  "Summarize README.md in one sentence."
```

[Open the full guide](/pr-cms-6147/docs/user-guide/box/guides/run-strands-harness/)

[Run the Box quickstart](/pr-cms-6147/docs/user-guide/box/quickstart/)

[View Box on GitHub](https://github.com/strands-agents/box)
