agentrun 1.0.0

Run claude-code, codex and pi in a sandbox with one command, on macOS, Linux, cloud containers and docker.

Files

File	Platform
agentrun-1.0.0-linux-x86_64	Linux x86_64, statically linked (musl)
agentrun-1.0.0-linux-arm64	Linux arm64, statically linked (musl)
agentrun-1.0.0-macos-arm64	macOS on Apple silicon
agentrun-1.0.0-macos-x86_64	macOS on Intel
SHA256SUMS	SHA-256 checksums of the four executables
THIRD-PARTY-LICENSES.txt	Licenses of the Rust crates built into the executables

Windows is not supported.

Check a downloaded file against SHA256SUMS in the same directory:

# macOS
shasum -a 256 -c SHA256SUMS --ignore-missing
# Linux
sha256sum -c SHA256SUMS --ignore-missing

Install

Download the file for your machine, make it executable and put it in your PATH. Replace linux-x86_64 with linux-arm64, macos-arm64 or macos-x86_64:

VERSION=1.0.0
FILE=agentrun-$VERSION-linux-x86_64
curl -LO https://github.com/yhnocoder/agentrun/releases/download/v$VERSION/$FILE
chmod +x $FILE
mkdir -p ~/.local/bin
mv $FILE ~/.local/bin/agentrun

If ~/.local/bin is not in your PATH (it is not by default on macOS), add export PATH="$HOME/.local/bin:$PATH" to your shell's startup file.

The macOS files are signed ad hoc and are not notarized. If you download one with a browser, remove the quarantine attribute after moving it:

xattr -d com.apple.quarantine ~/.local/bin/agentrun

Or install from crates.io:

cargo install agentrun --locked

On Linux, also install the sandbox tools:

# Debian, Ubuntu
sudo apt-get install -y bubblewrap socat
# Fedora
sudo dnf install -y bubblewrap socat

Then run agentrun doctor to check the runtimes, their login and the sandbox.

Supported runtimes

Runtime	Minimum version
claude-code	2.1.288
codex	0.159.2
pi (npm package @earendil-works/pi-coding-agent)	1.0.1

Documentation

• Quick start (Chinese): https://yhnocoder.github.io/agentrun/pages/quickstart.html
• Documentation, including the user guide and the developer pages: https://yhnocoder.github.io/agentrun/