Skip to content

Configuration ​

kaxa is a CLI for sandbox providers. Sprites is fully implemented. Modal supports create (including --sync), list, exec, console, snapshot, and destroy. E2B supports create (including --sync and --api), list, exec, console, restart, sync, and destroy. Docker supports create (including --sync, --template, and --api), list, exec, console, restart, sync, snapshot, and destroy through the Docker Sandboxes API. Daytona supports create (including --sync, --template, --api, and --block-all-network-access), list, exec, console, restart, sync, snapshot, and destroy through the Daytona API. Blaxel supports create (including --sync, --template, --api, and --disk-percent), list, exec, console, sync, snapshot, unarchive, and destroy through the Blaxel API. Features that only exist for Sprites are rejected for Modal, E2B, Docker, Daytona, and Blaxel with a message that names the providers that have them. Create, destroy, and the list URL auth prompt use the Dracula theme.

Install kaxa with Homebrew, a curl download, or from source: install.

Set up an account and token in Sprites account and token, Modal account and token, E2B account and API key, Docker Sandboxes, Daytona, or Blaxel.

Environment ​

Every command except version and --help loads configuration before it runs.

SourceWhat it sets
--providersprites, modal, e2b, docker, daytona, or blaxel for this invocation. list shows every provider when it is omitted
KAXA_DEFAULT_PROVIDERProvider when --provider is omitted, except for list
KAXA_SPRITES_TOKENSprites API token
KAXA_MODAL_TOKEN_IDModal token ID (ak-...)
KAXA_MODAL_TOKEN_SECRETModal token secret (as-...)
KAXA_E2B_API_KEYE2B API key (e2b_...)
KAXA_E2B_TEMPLATEE2B template for new sandboxes. Optional; default base
KAXA_DOCKER_IDDocker ID
KAXA_DOCKER_PATDocker personal access token, created with Allow Cloud Sandboxes access
KAXA_DOCKER_TEMPLATEDocker image for new sandboxes. Optional; default the shell agent image
KAXA_DAYTONA_API_KEYDaytona API key
KAXA_DAYTONA_TEMPLATEDaytona snapshot for new sandboxes. Optional; default the Daytona default snapshot
KAXA_BLAXEL_API_KEYBlaxel API key
KAXA_BLAXEL_WORKSPACEBlaxel workspace name
KAXA_BLAXEL_TEMPLATEBlaxel image for new sandboxes. Optional; default blaxel/base-image:latest
KAXA_BLAXEL_REGIONBlaxel region. Optional; default us-pdx-1
KAXA_BLAXEL_MEMORYBlaxel memory in megabytes. Optional; default 4096
KAXA_BLAXEL_DISK_PERCENTShare of Blaxel memory for the filesystem, from 10 to 95. Optional; empty uses 50. create --disk-percent overrides it

--provider wins over KAXA_DEFAULT_PROVIDER. Tokens are never read from a flag, from the Sprites CLI config file, from ~/.modal.toml, or from E2B_API_KEY, or from BL_API_KEY, BL_WORKSPACE, and ~/.blaxel.

Commands ​

CommandManual
kaxa versionversion
kaxa create (new)create
kaxa list (ls)list
kaxa execexec
kaxa console (ssh)console
kaxa syncsync
kaxa destroy (rm)destroy
kaxa restartrestart
kaxa unarchiveunarchive
kaxa upgradeupgrade
kaxa snapshotsnapshot
kaxa urlurl
kaxa mcp (start, init, config)mcp