You use it like so:

- Get the binary in whichever way you like (you can use Nix, Mise or just get it through the releases page).

- Configure via `.agent-run/config.toml` to make the folders you care about read-write, and add any environment variables.

- Run your agent like so: `agent-run <pi|claude|codex|opencode>`.

It's very generic so technically you can use this for any command.

Currently only supports Linux because I don't have access to a macOS machine and sandbox-exec looks daunting.