Repository navigation
Releases
v0.2.1
v0.2.0-rc.3
v0.2.0-rc.2
v0.1.0
Added
--no-installonkaxa syncandkaxa create --sync(andno_installon the MCPsync_repositoryandcreate_sandbox): the repository is copied and the toolchains are installed, and the dependency commands are printed for you to run.- Every sandbox has a
$HOME/workspacedirectory, sokaxa syncworks on a sandbox created without--sync. A Modal sandbox still needs--sync, because its tools image is chosen at create time.
Fixed
- A failed
create --syncon Daytona deletes the sandbox even when the API still cannot read it by name.
Changed
- The Go setup step downloads dependencies with
go mod downloadinstead of compiling withgo build. execandconsoleset the toolchainPATHin every sandbox, not only in one created with--sync.
Added
-
Sandbox providers: Fly.io Sprites, Modal, and E2B, behind one CLI. E2B supports create (with
--syncand--api), list, exec, console, restart, sync, and destroy, and readsKAXA_E2B_API_KEY.- E2B sandboxes can start from your own template with
create --template,KAXA_E2B_TEMPLATE, ortemplatein the MCPcreate_sandbox.
- E2B sandboxes can start from your own template with
-
Docker Sandboxes in Docker's cloud as the
dockerprovider, through the experimental Docker Sandboxes API and a Docker ID with a personal access token (KAXA_DOCKER_ID,KAXA_DOCKER_PAT). It supports create (with--sync,--template, and--api), list, exec, console, restart, sync, snapshot, and destroy, starts fromKAXA_DOCKER_TEMPLATEor--template, and needs a Docker Agentic Platform subscription.create --apistarts an HTTP service and publishes its port on a Docker URL.snapshotsaves the disk of a sandbox and restores it into a new sandbox with--to; Docker keeps the snapshots untilsnapshot delete, and kaxa lists only its own. A restored sandbox is recorded indocker-restored.jsonin the kaxa config directory, because Docker gives it no labels, so it is visible only on the machine that restored it. -
Daytona sandboxes as the
daytonaprovider, through the official Daytona Go SDK, with an API key (KAXA_DAYTONA_API_KEY). It supports create (with--sync,--template, and--api), list, exec, console, restart, sync, snapshot, and destroy, and starts fromKAXA_DAYTONA_TEMPLATEor--template. Sandboxes are persistent, so files survive a stop.create --apistarts an HTTP service and makes its port public on a Daytona preview URL.snapshotcaptures the disk as an image and restores it into a new sandbox with--to; kaxa lists only its own images, and keeps the comments indaytona-snapshots.jsonin the kaxa config directory. A template is the name of a Daytona snapshot. The live tests pass against the real service. -
kaxa mcp, which serves sandboxes to AI agents over the Model Context Protocol. -
Toolchain installation in Sprites sandboxes.
-
Sandbox snapshots: create, list, restore, and delete.
-
Install scripts for Linux, macOS (
install.sh), and Windows (install.ps1), attached to every release and checked againstchecksums.txt. -
Homebrew cask in
perylemke/tap, published for final versions only. -
Semantic versioning with semtag:
make releasefor final versions andmake prereleasefor test versions. -
KAXA_MCP_API_ENVlists the host variables an agent may copy into a service with a bareKEYinapi_env. -
timeout_secondson the MCPexectool, 30 minutes by default and 2 hours at most. -
Cosign keyless signature of
checksums.txt, SPDX SBOMs, and build provenance attestations on every release.install.shandinstall.ps1check the signature whencosignis installed, andREQUIRE_SIGNATURE=1makes it mandatory. -
Dependabot for GitHub Actions and Go modules.
Changed
- Configuration is read from environment variables only; Viper was removed.
kaxa --helplists every command in oneCommands:list, whichever providers implement it. Command help splitsFlags:fromProvider flags:, and--providernames the registered providers.- The project was renamed from
sboxtokaxa. kaxa create --apinames who can open the URL by provider: Sprites asks for a Sprites account, E2B and Daytona are public, and Docker says nothing, instead of always saying "requires a Sprites account".--api-envandapi_envreject names starting withMODAL_TOKEN_,FLY_, orSPRITES_as well asKAXA_.- GitHub Actions are pinned to commit SHAs, the release job runs in the
releaseenvironment with a read-only default token, and the Homebrew token reaches only the step that needs it. - The Modal base image is pinned by digest.
- Dependency installs after
--syncandsyncare tried up to three times when a network error such as an HTTP/2GOAWAYor a connection reset interrupts them. - Updated
golang.org/x/netto v0.62.0.
Security
- gosec SARIF scan in CI.
kaxa url <name> publicandcreate --running --publicare refused for a sandbox whose URL serves the unauthenticated tmux terminal.- The MCP server no longer copies arbitrary host environment variables into a service, and it refuses a
syncwhose scope is a home directory or the filesystem root. create --syncremoves credentials from.git/config, refuses untracked secret files, and no longer follows symlinks out of the repository.- Remote command output, provider error bodies, and project files are read with size limits, provider HTTP calls have timeouts, and MCP
exechas a deadline. - Names and URLs from the provider are stripped of control characters before they are printed, and only
http(s)URLs are opened in the browser. - An API command that starts with an option instead of a binary is rejected.
v0.1.0-rc.2
v0.1.0-rc.1
Changelog
- 8d62b0c Kaxa logo (#24)
- 704b0f9 feat: add install scripts and Claude Code rules (#25)
- 6c16487 feat: add sandbox snapshots (create, list, restore, delete) (#26)
- 34be5ba feat: semantic versioning with semtag and CHANGELOG (#27)
- 4d17d2b fix: harden public URLs, MCP env, repo sync, and release supply chain (#28)
v0.0.0-rc.1
Changelog
- 24fb651 Initial commit
- feaf9fc Remove Viper and load configuration from environment variables only (#12)
- 12c1979 feat: Include toolchains sprites (#20)
- 2b76cac feat: implement Sprites and serve sandboxes over MCP (#13)
- 2b0e376 feat: implement the Modal provider (#21)
- 613be2b feat: scaffold sbx cli (#1)
- 86bf3ba refactor: rename sbox to kaxa (#14)