upstash-box-js
The upstash-box-js SDK provides a TypeScript/JavaScript interface for creating and managing sandboxed cloud containers equipped with AI agents, command execution, file operations, and git integration. Deploy agents with multiple runtime options, execute shell commands and code snippets, manage workspaces through a filesystem API, and orchestrate git workflows—all from a single client. Supports snapshots, forking, and ephemeral short-lived containers for flexible agent orchestration.
upstash-box-js lets you build and run AI agents in sandboxed cloud containers with shell, filesystem, and git access.
AI-generated summary based on this skill's SKILL.md
Install
upstash/skills/upstash-box-js · repository language: JavaScript
git clone https://github.com/upstash/skills
cp -r skills/skills/upstash-box-js ~/.claude/skills/upstash-box-jsnpx skillfed install upstash/skills/upstash-box-jsFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What is upstash-box-js and what can I build with it?
upstash-box-js is a TypeScript/JavaScript SDK for creating and managing sandboxed cloud containers equipped with AI agents. With upstash-box-js, you can build and run AI agents in isolated environments, execute shell commands and code snippets, manage files and git repositories, and orchestrate multiple parallel boxes with webhooks and public URLs—all from a single client.
How do I run AI agents in containers with upstash-box-js?
upstash-box-js lets you build and run AI agents in sandboxed cloud containers with multiple runtime options. You can deploy agents that execute commands, manage files, and integrate with git workflows. The SDK supports streaming agent responses and structured typed outputs, making it easy to orchestrate complex agent behaviors in ephemeral, short-lived containers.
Can upstash-box-js handle shell execution and code snippets?
Yes. upstash-box-js enables you to execute shell commands and code snippets in isolated environments within sandboxed cloud containers. This allows you to run arbitrary code safely without affecting your main application, with full control over the execution context and environment variables.
What file and git operations does upstash-box-js support?
upstash-box-js provides a filesystem API for managing files, git repositories, and snapshots in ephemeral boxes. You can perform standard file operations, clone and manage git repos, create snapshots for state preservation, and fork containers—all through a unified interface designed for flexible agent orchestration.
How does upstash-box-js handle agent output and orchestration?
upstash-box-js supports streaming agent responses and structured typed outputs, allowing you to process results in real time. You can orchestrate multiple parallel boxes with webhooks and public URLs for fire-and-forget execution patterns, making it ideal for complex multi-agent workflows and distributed task execution.
What license does upstash-box-js use?
upstash-box-js is released under the MIT license, allowing free use, modification, and distribution in both open-source and commercial projects.
SKILL.md
rendered from the published skill — quoted content, verbatim
@upstash/box SDK
Sandboxed cloud containers with built-in AI agents, shell, filesystem, and git.
Install & Setup
npm install @upstash/box
Set UPSTASH_BOX_API_KEY env var or pass apiKey to constructors.
Box Lifecycle
```ts import { Box, Agent, ClaudeCode, BoxApiKey } from "@upstash/box"
// Create with agent + git + env vars const box = await Box.create({ runtime: "node", // "node" | "python" | "golang" | "ruby" | "rust" agent: { harness: Agent.ClaudeCode, // Agent.Codex | Agent.OpenCode model: ClaudeCode.Sonnet_4_5, // apiKey options: // omit → server decides which key to use // BoxApiKey.UpstashKey → use Upstash-provided LLM key // BoxApiKey.StoredKey → use key previously stored via Upstash Console // "sk-..." → direct API key string apiKey: BoxApiKey.UpstashKey, }, git: { // all fields
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
skills/upstash-box-js/SKILL.md