Agent skill · upstash
upstash-box-cli
Drive an Upstash Box (a remote sandboxed workspace) from the terminal with the `box` CLI. Use when asked to run commands, edit files, clone repos, run builds or tests, publish a public URL, browse or screenshot a page, open a pull request or issue with a screenshot attached, schedule recurring work, run an AI agent, or do any work inside a box rather than on this machine.
What it needs
About 8k tokens when loaded.
What this skill does
box operates on a remote container, not this machine. Your own file and shell tools act locally; anything that must happen inside the box goes through box. Install Authentication Every command needs an API key, or it fails with "API token required". Set it once, or pass --token on any single command. Create one at https://console.upstash.com/box. Selecting a box Resolution order is --box <id>, then $BOXID, then the nearest .box file (searched upward). Create one and pin it to the working directory: --keep-alive, --browser and --env can only be chosen at create time; to change any of them you make a new box: --keep-alive matters whenever you leave something running: an idle box pauses, and the detached server in the example below dies with it. --env is per-box; box env is account-level and applies to every box you create later. paused is not an error; the next command resumes the box. Clean up when the work is done. Boxes cost money while they exist: Never run box create or box connect without --no-repl: they open an interactive REPL and will hang. box from-snapshot takes --no-repl too. Running commands Put the remote command after --, or its flags are parsed as box's own. One argument is a shell expression, sent as written, so pipes and redirection work. Several arguments are argv and are quoted individually, so an argument containing spaces stays one argument. The remote command's exit code is passed through, so box exec -- npm test && ... chains normally. Exit code 125 means the CLI itself failed (bad box, bad flags), never a status the remote command returned. A background server dies with the command that started it. Detach it: Inline code, when a shell one-liner would be worse than a program: Building something and handing back a link "Make me a snake game, use Upstash Box" is a request to build it in a box, run it there, and reply with a URL the user can open. Do the whole thing; do not stop at writing the file. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills upstash/upstash-box-cli