Repository navigation
What's new in v0.2.2
Box v0.2.2 fixes Codex startup on Linux, improves compatibility with linked tool installations, and adds streaming responses.
- Codex on Linux: Fix filesystem queries that Codex needs before opening SQLite, and accept valid Docker namespace mounts during executable validation. Codex needs no binary change. #356, #382
- Bun and Rustup installations: Accept executables with multiple hard links, which are names for the same file, when sandboxed processes cannot write through those names. On Linux, avoid recursive scans when filename and mount checks establish that the names remain protected. #347, #381
- Interactive terminals: Keep later Box diagnostics from overwriting the agent's screen. Permission details and warnings remain visible at startup, and piped diagnostics remain live. #353
- Experimental tool grammars: Apply policy to parsed command actions and effects, such as a Git force push. Enable
tool-grammars = trueunder[experimental-features]in Box'sbox.toml. Grammars bind to the declared command name and executable, including commands resolved through Box CLI tool packs. #327, #352, #358 - Streaming responses: Deliver HTTP responses progressively while redacting configured credential values, including values split across chunks. #345
- Model Context Protocol (MCP): Support protocol
2026-07-28for local tool servers over standard input and output, including input-answer retries. Canceled admitted calls in that protocol still count in policy history. Legacy protocol versions remain supported. #350 - Policy corrections: Preserve history across restarts for unchanged rules on MCP tool actions when they still validate against the saved tool schema. Fix policy evaluation for arguments such as a string or list of strings, and recover from discovery failures once Box installs a complete policy. #383, #360, #225
- Linux runs as root: Honor explicit directory write grants when Box starts as root. New output can remain root-owned. #348
Compatibility notes
- Tool grammars remain experimental and off by default. Enabling a grammar replaces
shell:spawndecisions for its bound command. Grammars inspect command lines, not child processes, environment variables, or program configuration. Review the tool grammar guide before enabling them. - Streaming retains the 16 MiB request and MCP tool-list capture limits, and the 300-second upstream deadline. Credential redaction can delay small events until more data arrives or the response finishes.
- Linux filesystem queries return zero capacity and free-space counts. Programs that interpret those values as a full filesystem can reject operations. Container security profiles must permit the Linux interfaces that Box uses to answer these queries. Restrictive profiles can still block Box startup or filesystem queries. See the filesystem-query fix and its limits.
- For Rust source consumers,
EffectAttempt::ResponseReleaseinstrands-box-egress-gatewayno longer includesbody_bytes. Remove that field from code that constructs the variant.
This release includes macOS Apple silicon and Amazon Linux 2023 ARM64 packages. Linux x86-64 remains a build artifact and is not a published package.
Download
Download Box Core into a local directory on macOS (Apple silicon):
curl -fsSL https://raw.githubusercontent.com/strands-agents/box/main/download.sh | shPin this exact release:
curl -fsSL https://raw.githubusercontent.com/strands-agents/box/main/download.sh | BOX_VERSION=v0.2.2 shThe downloader picks a tarball from the assets below, verifies it against SHA256SUMS.txt, and unpacks its files into ./box-core. Nothing is installed: your $PATH and system directories are untouched. Override the directory with BOX_DOWNLOAD_DIR=/some/path. Write a box.toml and a policy, then run the box by path (./box-core/box run --config ./box.toml).
Linux ARM64
Package availability does not establish security acceptance.
For Amazon Linux 2023 ARM64, download box-v0.2.2-linux-arm64.tar.gz and SHA256SUMS.txt from the assets below. In the download directory, run:
awk '$2 == "box-v0.2.2-linux-arm64.tar.gz"' SHA256SUMS.txt > box-linux.sha256 &&
test -s box-linux.sha256 &&
sha256sum --check box-linux.sha256 &&
mkdir -p box-core &&
tar -C box-core -xzf box-v0.2.2-linux-arm64.tar.gz &&
./box-core/box run --config ./box.tomlThe Linux build requires glibc 2.34 or newer, libgcc, and a host that permits Box's namespace, mount, and syscall-filter setup.
Assets
The macOS archive contains Box.app, a box launcher, and helper links into its signed and notarized bundle. Keep that directory intact. Linux archives contain box beside its helpers. SHA256SUMS.txt contains each archive's checksum.