Agent skill · software engineering · upstash
upstash-box-js
Work with the @upstash/box TypeScript/JavaScript SDK for sandboxed cloud containers with AI agents, shell, filesystem, git, cron schedules, snapshots, and a headless browser. Use when building with Upstash Box, creating a sandbox or isolated environment to run untrusted or agent-generated code, running AI coding agents in containers, giving an agent a cloud dev environment with a shell and repository, browser automation from a box, scheduling recurring jobs inside a box, saving and restoring snapshots, or orchestrating parallel boxes.
Why this skill is useful
Provides specific commands and patterns for managing sandboxed environments with the Upstash Box SDK that the AI wouldn't reliably generate on its own.
What it needs
Requires @upstash/box installed locally. Requires upstash account access. About 10k tokens when loaded. Last updated 2026-07-14. 17 stars on the source repository.
What this skill does
@upstash/box SDK Sandboxed cloud containers with built-in AI agents, shell, filesystem, git, cron schedules, and an optional headless browser. The Python SDK (upstash-box) mirrors this API with snakecase names — see the upstash-box-py skill for the Python spelling of everything below. Install & Setup Set UPSTASHBOXAPIKEY env var or pass apiKey to constructors. Anonymous telemetry headers are sent by default. Opt out with the UPSTASHDISABLETELEMETRY env var, or enableTelemetry: false in the config (the only option on runtimes without process.env, e.g. Cloudflare Workers). Box Lifecycle Account-level env vars Injected into every box you create. Agent Runs Agent options (per harness) options is forwarded to the harness — the accepted keys depend on which one the box runs. Typing the box (Box.create<Agent.ClaudeCode>({...})) narrows options to that harness's shape. Codex keys are converted to the backend's snakecase for you — always write them camelCase. Harness & model harness is required (provider / runner are deprecated aliases). Model enums: ClaudeCode, OpenAICodex, OpenCodeModel, CursorModel, OpenRouterModel, VercelModel — or any plain provider-prefixed string. Custom harness Run your own agent binary inside the box instead of a managed harness. Run Fields Every run (agent, command, or code) returns a Run<T>: Shell Execution Live sessions exec.session() opens a WebSocket to a process that is still running — stdin, streamed stdout/stderr, PTY resize, and signals. Node-only: auth is a handshake header, which browsers cannot set (ws ships as an SDK dependency, nothing to install). Available on Box and EphemeralBox. The session owns the process: close(), a dropped connection, or your process exiting all kill the command, and a session cannot be reattached. Use wait() to run something to completion. Filesystem cd / Working Directory The SDK tracks cwd client-side. All operations (exec, files, git, agent) run relative to it. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills upstash/upstash-box-js