@upstash/box-cli 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Upstash, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# @upstash/box-cli
+
+REPL-first CLI for [Upstash Box](https://upstash.com/docs/box) — create and interact with sandboxed AI coding agents from the terminal.
+
+## Installation
+
+```bash
+npm install -g @upstash/box-cli
+```
+
+Or run directly from the monorepo:
+
+```bash
+pnpm build
+node packages/cli/dist/index.js --help
+```
+
+## Authentication
+
+Provide your Upstash Box API token via the `--token` flag or the `UPSTASH_BOX_TOKEN` environment variable:
+
+```bash
+export UPSTASH_BOX_TOKEN=abx_...
+```
+
+## Commands
+
+### `box create`
+
+Create a new box and enter an interactive REPL.
+
+```bash
+box create \
+  --agent-model claude/sonnet_4_5 \
+  --agent-api-key $CLAUDE_KEY \
+  --runtime node \
+  --git-token $GITHUB_TOKEN \
+  --env NODE_ENV=production \
+  --env DEBUG=true
+```
+
+| Flag | Description |
+|------|-------------|
+| `--token` | Upstash Box API token |
+| `--runtime` | Runtime environment (`node`, `python`, `golang`, `ruby`, `rust`) |
+| `--agent-model` | Agent model identifier (required) |
+| `--agent-api-key` | Agent API key — Anthropic or OpenAI (required) |
+| `--git-token` | GitHub personal access token |
+| `--env KEY=VAL` | Environment variable (repeatable) |
+
+### `box connect [box-id]`
+
+Connect to an existing box and enter the REPL. If no box ID is given, connects to the most recent box.
+
+```bash
+box connect box_abc123
+box connect  # connects to most recent
+```
+
+### `box from-snapshot <snapshot-id>`
+
+Create a new box from a snapshot and enter the REPL. Accepts the same flags as `create`.
+
+```bash
+box from-snapshot snap_abc123 \
+  --agent-model claude/sonnet_4_5 \
+  --agent-api-key $CLAUDE_KEY
+```
+
+### `box list`
+
+List all boxes.
+
+```bash
+box list
+```
+
+### `box get <box-id>`
+
+Print box details as JSON.
+
+```bash
+box get box_abc123
+```
+
+## Interactive REPL
+
+After `create`, `connect`, or `from-snapshot`, you enter an interactive REPL session:
+
+```
+Connected to box box_abc123
+Type a prompt to run the agent, or use commands: run, exec, files, git, snapshot, stop, delete, exit
+
+box_abc123> Fix the bug in auth.ts
+```
+
+### REPL commands
+
+Any text entered is sent to the agent by default. You can also use explicit commands (with or without a `/` prefix):
+
+| Command | Description |
+|---------|-------------|
+| `run <prompt>` | Run the agent with a prompt (streaming output) |
+| `exec <command>` | Execute a shell command in the box |
+| `files read <path>` | Read a file |
+| `files write <path> <content>` | Write a file |
+| `files list [path]` | List files in a directory |
+| `files upload <local> <dest>` | Upload a local file |
+| `files download [path]` | Download files from the box |
+| `git clone <repo> [branch]` | Clone a repository |
+| `git diff` | Show git diff |
+| `git create-pr <title>` | Create a pull request |
+| `snapshot [name]` | Save a snapshot of the current state |
+| `stop` | Stop the box and exit |
+| `delete` | Delete the box and exit |
+| `exit` | Exit the REPL (box keeps running) |
+
+### Examples
+
+```
+box_abc123> Add error handling to the payment service
+box_abc123> exec npm test
+box_abc123> files list src/
+box_abc123> git diff
+box_abc123> snapshot before-refactor
+box_abc123> exit
+```
+
+## License
+
+MIT

package/dist/auth.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Resolves the API token from flag or environment variable.
+ */
+export declare function resolveToken(flagToken?: string): string;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAOvD"}

package/dist/auth.js

@@ -0,0 +1,12 @@
+/**
+ * Resolves the API token from flag or environment variable.
+ */
+export function resolveToken(flagToken) {
+    const token = flagToken ?? process.env.UPSTASH_BOX_TOKEN;
+    if (!token) {
+        console.error("Error: API token required. Use --token flag or set UPSTASH_BOX_TOKEN env var.");
+        process.exit(1);
+    }
+    return token;
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,SAAkB;IAC7C,MAAM,KAAK,GAAG,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACzD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,+EAA+E,CAAC,CAAC;QAC/F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/commands/connect.d.ts

@@ -0,0 +1,6 @@
+interface ConnectFlags {
+    token?: string;
+}
+export declare function connectCommand(boxId: string | undefined, flags: ConnectFlags): Promise<void>;
+export {};
+//# sourceMappingURL=connect.d.ts.map

package/dist/commands/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/commands/connect.ts"],"names":[],"mappings":"AAIA,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBlG"}

package/dist/commands/connect.js

@@ -0,0 +1,21 @@
+import { Box } from "@upstash/box";
+import { resolveToken } from "../auth.js";
+import { startRepl } from "../repl.js";
+export async function connectCommand(boxId, flags) {
+    const apiKey = resolveToken(flags.token);
+    let targetId = boxId;
+    // If no box ID provided, connect to most recent
+    if (!targetId) {
+        console.log("No box ID specified, connecting to most recent...");
+        const boxes = await Box.list({ apiKey });
+        if (boxes.length === 0) {
+            console.error("No boxes found.");
+            process.exit(1);
+        }
+        targetId = boxes[0].id;
+    }
+    console.log(`Connecting to box ${targetId}...`);
+    const box = await Box.get(targetId, { apiKey });
+    await startRepl(box);
+}
+//# sourceMappingURL=connect.js.map

package/dist/commands/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../src/commands/connect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAMvC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAyB,EAAE,KAAmB;IACjF,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEzC,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,gDAAgD;IAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,qBAAqB,QAAQ,KAAK,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/commands/create.d.ts

@@ -0,0 +1,11 @@
+interface CreateFlags {
+    token?: string;
+    runtime?: string;
+    agentModel?: string;
+    agentApiKey?: string;
+    gitToken?: string;
+    env?: string[];
+}
+export declare function createCommand(flags: CreateFlags): Promise<void>;
+export {};
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAIA,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCrE"}

package/dist/commands/create.js

@@ -0,0 +1,35 @@
+import { Box } from "@upstash/box";
+import { resolveToken } from "../auth.js";
+import { startRepl } from "../repl.js";
+export async function createCommand(flags) {
+    const apiKey = resolveToken(flags.token);
+    if (!flags.agentModel) {
+        console.error("Error: --agent-model is required");
+        process.exit(1);
+    }
+    if (!flags.agentApiKey) {
+        console.error("Error: --agent-api-key is required");
+        process.exit(1);
+    }
+    const env = {};
+    if (flags.env) {
+        for (const e of flags.env) {
+            const idx = e.indexOf("=");
+            if (idx === -1) {
+                console.error(`Invalid env format: ${e} (expected KEY=VAL)`);
+                process.exit(1);
+            }
+            env[e.slice(0, idx)] = e.slice(idx + 1);
+        }
+    }
+    console.log("Creating box...");
+    const box = await Box.create({
+        apiKey,
+        runtime: flags.runtime,
+        agent: { model: flags.agentModel, apiKey: flags.agentApiKey },
+        git: flags.gitToken ? { token: flags.gitToken } : undefined,
+        env: Object.keys(env).length > 0 ? env : undefined,
+    });
+    await startRepl(box);
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAWvC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAkB;IACpD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEzC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,qBAAqB,CAAC,CAAC;gBAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC;QAC3B,MAAM;QACN,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,WAAW,EAAE;QAC7D,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS;QAC3D,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;KACnD,CAAC,CAAC;IAEH,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/commands/from-snapshot.d.ts

@@ -0,0 +1,11 @@
+interface FromSnapshotFlags {
+    token?: string;
+    runtime?: string;
+    agentModel?: string;
+    agentApiKey?: string;
+    gitToken?: string;
+    env?: string[];
+}
+export declare function fromSnapshotCommand(snapshotId: string, flags: FromSnapshotFlags): Promise<void>;
+export {};
+//# sourceMappingURL=from-snapshot.d.ts.map

package/dist/commands/from-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-snapshot.d.ts","sourceRoot":"","sources":["../../src/commands/from-snapshot.ts"],"names":[],"mappings":"AAIA,UAAU,iBAAiB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCrG"}

package/dist/commands/from-snapshot.js

@@ -0,0 +1,35 @@
+import { Box } from "@upstash/box";
+import { resolveToken } from "../auth.js";
+import { startRepl } from "../repl.js";
+export async function fromSnapshotCommand(snapshotId, flags) {
+    const apiKey = resolveToken(flags.token);
+    if (!flags.agentModel) {
+        console.error("Error: --agent-model is required");
+        process.exit(1);
+    }
+    if (!flags.agentApiKey) {
+        console.error("Error: --agent-api-key is required");
+        process.exit(1);
+    }
+    const env = {};
+    if (flags.env) {
+        for (const e of flags.env) {
+            const idx = e.indexOf("=");
+            if (idx === -1) {
+                console.error(`Invalid env format: ${e} (expected KEY=VAL)`);
+                process.exit(1);
+            }
+            env[e.slice(0, idx)] = e.slice(idx + 1);
+        }
+    }
+    console.log("Creating box from snapshot...");
+    const box = await Box.fromSnapshot(snapshotId, {
+        apiKey,
+        runtime: flags.runtime,
+        agent: { model: flags.agentModel, apiKey: flags.agentApiKey },
+        git: flags.gitToken ? { token: flags.gitToken } : undefined,
+        env: Object.keys(env).length > 0 ? env : undefined,
+    });
+    await startRepl(box);
+}
+//# sourceMappingURL=from-snapshot.js.map

package/dist/commands/from-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-snapshot.js","sourceRoot":"","sources":["../../src/commands/from-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAWvC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAAkB,EAAE,KAAwB;IACpF,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEzC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,qBAAqB,CAAC,CAAC;gBAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,UAAU,EAAE;QAC7C,MAAM;QACN,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,WAAW,EAAE;QAC7D,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS;QAC3D,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;KACnD,CAAC,CAAC;IAEH,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/commands/get.d.ts

@@ -0,0 +1,6 @@
+interface GetFlags {
+    token?: string;
+}
+export declare function getCommand(boxId: string, flags: GetFlags): Promise<void>;
+export {};
+//# sourceMappingURL=get.d.ts.map

package/dist/commands/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../src/commands/get.ts"],"names":[],"mappings":"AAIA,UAAU,QAAQ;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9E"}

package/dist/commands/get.js

@@ -0,0 +1,9 @@
+import { Box } from "@upstash/box";
+import { resolveToken } from "../auth.js";
+import { formatJSON } from "../output.js";
+export async function getCommand(boxId, flags) {
+    const apiKey = resolveToken(flags.token);
+    const box = await Box.get(boxId, { apiKey });
+    console.log(formatJSON({ id: box.id }));
+}
+//# sourceMappingURL=get.js.map

package/dist/commands/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../src/commands/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM1C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAa,EAAE,KAAe;IAC7D,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/commands/list.d.ts

@@ -0,0 +1,6 @@
+interface ListFlags {
+    token?: string;
+}
+export declare function listCommand(flags: ListFlags): Promise<void>;
+export {};
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAIA,UAAU,SAAS;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAYjE"}

package/dist/commands/list.js

@@ -0,0 +1,14 @@
+import { Box } from "@upstash/box";
+import { resolveToken } from "../auth.js";
+export async function listCommand(flags) {
+    const apiKey = resolveToken(flags.token);
+    const boxes = await Box.list({ apiKey });
+    if (boxes.length === 0) {
+        console.log("No boxes found.");
+        return;
+    }
+    for (const b of boxes) {
+        console.log(`${b.id}\t${b.status}\t${b.model}\t${b.created_at}`);
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO1C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAgB;IAChD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAEzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "dotenv/config";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import { Command } from "commander";
+import { createCommand } from "./commands/create.js";
+import { connectCommand } from "./commands/connect.js";
+import { fromSnapshotCommand } from "./commands/from-snapshot.js";
+import { listCommand } from "./commands/list.js";
+import { getCommand } from "./commands/get.js";
+const program = new Command();
+program
+    .name("box")
+    .description("CLI for Upstash Box — REPL-first interface for AI coding agents")
+    .version("0.1.0");
+program
+    .command("create")
+    .description("Create a new box and enter the REPL")
+    .option("--token <token>", "Upstash Box API token")
+    .option("--runtime <runtime>", "Runtime environment (node, python, golang, ruby, rust)")
+    .option("--agent-model <model>", "Agent model identifier")
+    .option("--agent-api-key <key>", "Agent API key (Anthropic or OpenAI)")
+    .option("--git-token <token>", "GitHub personal access token")
+    .option("--env <KEY=VAL>", "Environment variable (repeatable)", (val, prev) => [...prev, val], [])
+    .action((opts) => createCommand(opts));
+program
+    .command("connect [box-id]")
+    .description("Connect to an existing box (or most recent) and enter the REPL")
+    .option("--token <token>", "Upstash Box API token")
+    .action((boxId, opts) => connectCommand(boxId, opts));
+program
+    .command("from-snapshot <snapshot-id>")
+    .description("Create a new box from a snapshot and enter the REPL")
+    .option("--token <token>", "Upstash Box API token")
+    .option("--runtime <runtime>", "Runtime environment")
+    .option("--agent-model <model>", "Agent model identifier")
+    .option("--agent-api-key <key>", "Agent API key")
+    .option("--git-token <token>", "GitHub personal access token")
+    .option("--env <KEY=VAL>", "Environment variable (repeatable)", (val, prev) => [...prev, val], [])
+    .action((snapshotId, opts) => fromSnapshotCommand(snapshotId, opts));
+program
+    .command("list")
+    .description("List all boxes")
+    .option("--token <token>", "Upstash Box API token")
+    .action((opts) => listCommand(opts));
+program
+    .command("get <box-id>")
+    .description("Get details about a box")
+    .option("--token <token>", "Upstash Box API token")
+    .action((boxId, opts) => getCommand(boxId, opts));
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,iEAAiE,CAAC;KAC9E,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,qCAAqC,CAAC;KAClD,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;KAClD,MAAM,CAAC,qBAAqB,EAAE,wDAAwD,CAAC;KACvF,MAAM,CAAC,uBAAuB,EAAE,wBAAwB,CAAC;KACzD,MAAM,CAAC,uBAAuB,EAAE,qCAAqC,CAAC;KACtE,MAAM,CAAC,qBAAqB,EAAE,8BAA8B,CAAC;KAC7D,MAAM,CAAC,iBAAiB,EAAE,mCAAmC,EAAE,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,EAAc,CAAC;KAC/H,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;AAEzC,OAAO;KACJ,OAAO,CAAC,kBAAkB,CAAC;KAC3B,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;KAClD,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AAExD,OAAO;KACJ,OAAO,CAAC,6BAA6B,CAAC;KACtC,WAAW,CAAC,qDAAqD,CAAC;KAClE,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;KAClD,MAAM,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;KACpD,MAAM,CAAC,uBAAuB,EAAE,wBAAwB,CAAC;KACzD,MAAM,CAAC,uBAAuB,EAAE,eAAe,CAAC;KAChD,MAAM,CAAC,qBAAqB,EAAE,8BAA8B,CAAC;KAC7D,MAAM,CAAC,iBAAiB,EAAE,mCAAmC,EAAE,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,EAAc,CAAC;KAC/H,MAAM,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;AAEvE,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,gBAAgB,CAAC;KAC7B,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;KAClD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;AAEvC,OAAO;KACJ,OAAO,CAAC,cAAc,CAAC;KACvB,WAAW,CAAC,yBAAyB,CAAC;KACtC,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;KAClD,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AAEpD,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/output.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Format data as JSON for display.
+ */
+export declare function formatJSON(data: unknown): string;
+/**
+ * Format raw text for display.
+ */
+export declare function formatRaw(text: string): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/output.js

@@ -0,0 +1,13 @@
+/**
+ * Format data as JSON for display.
+ */
+export function formatJSON(data) {
+    return JSON.stringify(data, null, 2);
+}
+/**
+ * Format raw text for display.
+ */
+export function formatRaw(text) {
+    return text;
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/repl-commands/delete.d.ts

@@ -0,0 +1,6 @@
+import type { Box } from "@upstash/box";
+/**
+ * Delete the box. Returns true to signal the REPL to exit.
+ */
+export declare function handleDelete(box: Box, _args: string): Promise<boolean>;
+//# sourceMappingURL=delete.d.ts.map

package/dist/repl-commands/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../src/repl-commands/delete.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC;;GAEG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI5E"}

package/dist/repl-commands/delete.js

@@ -0,0 +1,9 @@
+/**
+ * Delete the box. Returns true to signal the REPL to exit.
+ */
+export async function handleDelete(box, _args) {
+    await box.delete();
+    console.log(`Box ${box.id} deleted.`);
+    return true;
+}
+//# sourceMappingURL=delete.js.map

package/dist/repl-commands/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../src/repl-commands/delete.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAQ,EAAE,KAAa;IACxD,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,EAAE,WAAW,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/repl-commands/exec.d.ts

@@ -0,0 +1,6 @@
+import type { Box } from "@upstash/box";
+/**
+ * Execute a shell command in the box.
+ */
+export declare function handleExec(box: Box, command: string): Promise<void>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/repl-commands/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/repl-commands/exec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE"}

package/dist/repl-commands/exec.js

@@ -0,0 +1,14 @@
+/**
+ * Execute a shell command in the box.
+ */
+export async function handleExec(box, command) {
+    if (!command) {
+        console.log("Usage: exec <command>");
+        return;
+    }
+    const run = await box.exec(command);
+    const result = await run.result();
+    if (result)
+        console.log(result);
+}
+//# sourceMappingURL=exec.js.map

package/dist/repl-commands/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/repl-commands/exec.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAQ,EAAE,OAAe;IACxD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC;IAClC,IAAI,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}

package/dist/repl-commands/files.d.ts

@@ -0,0 +1,6 @@
+import type { Box } from "@upstash/box";
+/**
+ * Handle file subcommands: read, write, list, upload, download.
+ */
+export declare function handleFiles(box: Box, args: string): Promise<void>;
+//# sourceMappingURL=files.d.ts.map

package/dist/repl-commands/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/repl-commands/files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuDvE"}

package/dist/repl-commands/files.js

@@ -0,0 +1,59 @@
+/**
+ * Handle file subcommands: read, write, list, upload, download.
+ */
+export async function handleFiles(box, args) {
+    const parts = args.split(/\s+/);
+    const sub = parts[0];
+    switch (sub) {
+        case "read": {
+            const path = parts[1];
+            if (!path) {
+                console.log("Usage: files read <path>");
+                return;
+            }
+            const content = await box.files.read(path);
+            console.log(content);
+            break;
+        }
+        case "write": {
+            const path = parts[1];
+            const content = parts.slice(2).join(" ");
+            if (!path || !content) {
+                console.log("Usage: files write <path> <content>");
+                return;
+            }
+            await box.files.write({ path, content });
+            console.log(`Written to ${path}`);
+            break;
+        }
+        case "list": {
+            const path = parts[1];
+            const files = await box.files.list(path);
+            for (const f of files) {
+                const indicator = f.is_dir ? "/" : "";
+                console.log(`${f.name}${indicator}\t${f.size}`);
+            }
+            break;
+        }
+        case "upload": {
+            const localPath = parts[1];
+            const destination = parts[2];
+            if (!localPath || !destination) {
+                console.log("Usage: files upload <local-path> <destination>");
+                return;
+            }
+            await box.files.upload([{ path: localPath, destination }]);
+            console.log(`Uploaded ${localPath} → ${destination}`);
+            break;
+        }
+        case "download": {
+            const path = parts[1];
+            await box.files.download(path ? { path } : undefined);
+            console.log("Downloaded.");
+            break;
+        }
+        default:
+            console.log("Usage: files <read|write|list|upload|download> [args...]");
+    }
+}
+//# sourceMappingURL=files.js.map

package/dist/repl-commands/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/repl-commands/files.ts"],"names":[],"mappings":"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"}

package/dist/repl-commands/git.d.ts

@@ -0,0 +1,6 @@
+import type { Box } from "@upstash/box";
+/**
+ * Handle git subcommands: clone, diff, create-pr.
+ */
+export declare function handleGit(box: Box, args: string): Promise<void>;
+//# sourceMappingURL=git.d.ts.map

package/dist/repl-commands/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/repl-commands/git.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCrE"}

package/dist/repl-commands/git.js

@@ -0,0 +1,38 @@
+/**
+ * Handle git subcommands: clone, diff, create-pr.
+ */
+export async function handleGit(box, args) {
+    const parts = args.split(/\s+/);
+    const sub = parts[0];
+    switch (sub) {
+        case "clone": {
+            const repo = parts[1];
+            const branch = parts[2];
+            if (!repo) {
+                console.log("Usage: git clone <repo> [branch]");
+                return;
+            }
+            await box.git.clone({ repo, branch });
+            console.log(`Cloned ${repo}`);
+            break;
+        }
+        case "diff": {
+            const diff = await box.git.diff();
+            console.log(diff || "(no changes)");
+            break;
+        }
+        case "create-pr": {
+            const title = parts.slice(1).join(" ");
+            if (!title) {
+                console.log("Usage: git create-pr <title>");
+                return;
+            }
+            const pr = await box.git.createPR({ title });
+            console.log(`PR #${pr.number}: ${pr.url}`);
+            break;
+        }
+        default:
+            console.log("Usage: git <clone|diff|create-pr> [args...]");
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/repl-commands/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/repl-commands/git.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAQ,EAAE,IAAY;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAErB,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACxB,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;gBAChD,OAAO;YACT,CAAC;YACD,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YAC9B,MAAM;QACR,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,cAAc,CAAC,CAAC;YACpC,MAAM;QACR,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;gBAC5C,OAAO;YACT,CAAC;YACD,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;YAC3C,MAAM;QACR,CAAC;QACD;YACE,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/repl-commands/run.d.ts

@@ -0,0 +1,6 @@
+import type { Box } from "@upstash/box";
+/**
+ * Run the agent with a prompt, streaming output to stdout.
+ */
+export declare function handleRun(box: Box, prompt: string): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/repl-commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/repl-commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASvE"}

package/dist/repl-commands/run.js

@@ -0,0 +1,14 @@
+/**
+ * Run the agent with a prompt, streaming output to stdout.
+ */
+export async function handleRun(box, prompt) {
+    if (!prompt) {
+        console.log("Usage: run <prompt>");
+        return;
+    }
+    for await (const chunk of box.agent.stream({ prompt })) {
+        process.stdout.write(chunk);
+    }
+    console.log();
+}
+//# sourceMappingURL=run.js.map

package/dist/repl-commands/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/repl-commands/run.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAQ,EAAE,MAAc;IACtD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO;IACT,CAAC;IACD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC"}

package/dist/repl-commands/snapshot.d.ts

@@ -0,0 +1,6 @@
+import type { Box } from "@upstash/box";
+/**
+ * Create a snapshot of the current box state.
+ */
+export declare function handleSnapshot(box: Box, args: string): Promise<void>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/repl-commands/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/repl-commands/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC;;GAEG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1E"}

package/dist/repl-commands/snapshot.js

@@ -0,0 +1,9 @@
+/**
+ * Create a snapshot of the current box state.
+ */
+export async function handleSnapshot(box, args) {
+    const name = args.trim() || `snapshot-${Date.now()}`;
+    const snapshot = await box.snapshot({ name });
+    console.log(`Snapshot created: ${snapshot.id} (${snapshot.name})`);
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/repl-commands/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/repl-commands/snapshot.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAQ,EAAE,IAAY;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,YAAY,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACrD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,qBAAqB,QAAQ,CAAC,EAAE,KAAK,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;AACrE,CAAC"}

package/dist/repl-commands/stop.d.ts

@@ -0,0 +1,6 @@
+import type { Box } from "@upstash/box";
+/**
+ * Stop the box. Returns true to signal the REPL to exit.
+ */
+export declare function handleStop(box: Box, _args: string): Promise<boolean>;
+//# sourceMappingURL=stop.d.ts.map

package/dist/repl-commands/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../src/repl-commands/stop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI1E"}

package/dist/repl-commands/stop.js

@@ -0,0 +1,9 @@
+/**
+ * Stop the box. Returns true to signal the REPL to exit.
+ */
+export async function handleStop(box, _args) {
+    await box.stop();
+    console.log(`Box ${box.id} stopped.`);
+    return true;
+}
+//# sourceMappingURL=stop.js.map

package/dist/repl-commands/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../src/repl-commands/stop.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAQ,EAAE,KAAa;IACtD,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IACjB,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,EAAE,WAAW,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/repl.d.ts

@@ -0,0 +1,6 @@
+import type { Box } from "@upstash/box";
+/**
+ * Start an interactive REPL session for the given box.
+ */
+export declare function startRepl(box: Box): Promise<void>;
+//# sourceMappingURL=repl.d.ts.map

package/dist/repl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../src/repl.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAmBxC;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CvD"}

package/dist/repl.js

@@ -0,0 +1,68 @@
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+import { handleRun } from "./repl-commands/run.js";
+import { handleExec } from "./repl-commands/exec.js";
+import { handleFiles } from "./repl-commands/files.js";
+import { handleGit } from "./repl-commands/git.js";
+import { handleSnapshot } from "./repl-commands/snapshot.js";
+import { handleStop } from "./repl-commands/stop.js";
+import { handleDelete } from "./repl-commands/delete.js";
+const COMMANDS = {
+    run: handleRun,
+    exec: handleExec,
+    files: handleFiles,
+    git: handleGit,
+    snapshot: handleSnapshot,
+    stop: handleStop,
+    delete: handleDelete,
+};
+/**
+ * Start an interactive REPL session for the given box.
+ */
+export async function startRepl(box) {
+    const rl = createInterface({ input: stdin, output: stdout });
+    console.log(`\nConnected to box ${box.id}`);
+    console.log(`Type a prompt to run the agent, or use commands: ${Object.keys(COMMANDS).join(", ")}, exit\n`);
+    try {
+        while (true) {
+            const input = await rl.question(`${box.id}> `);
+            const trimmed = input.trim();
+            if (!trimmed)
+                continue;
+            if (trimmed === "exit" || trimmed === "/exit") {
+                console.log("Goodbye.");
+                break;
+            }
+            // Strip leading slash if present
+            const normalized = trimmed.startsWith("/") ? trimmed.slice(1) : trimmed;
+            // Find matching command
+            const spaceIdx = normalized.indexOf(" ");
+            const cmdName = spaceIdx === -1 ? normalized : normalized.slice(0, spaceIdx);
+            const args = spaceIdx === -1 ? "" : normalized.slice(spaceIdx + 1).trim();
+            const handler = COMMANDS[cmdName];
+            if (handler) {
+                try {
+                    const shouldExit = await handler(box, args);
+                    if (shouldExit === true)
+                        break;
+                }
+                catch (err) {
+                    console.error(`Error: ${err instanceof Error ? err.message : err}`);
+                }
+            }
+            else {
+                // Bare text → implicit run
+                try {
+                    await handleRun(box, trimmed);
+                }
+                catch (err) {
+                    console.error(`Error: ${err instanceof Error ? err.message : err}`);
+                }
+            }
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=repl.js.map

package/dist/repl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.js","sourceRoot":"","sources":["../src/repl.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@upstash/box-cli",
+  "version": "0.0.0",
+  "description": "CLI for Upstash Box — REPL-first interface for AI coding agents",
+  "type": "module",
+  "bin": {
+    "box": "./dist/index.js"
+  },
+  "main": "dist/index.js",
+  "keywords": [
+    "upstash",
+    "box",
+    "cli",
+    "ai-agent"
+  ],
+  "author": "Upstash",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^13.0.0",
+    "dotenv": "^17.3.1",
+    "@upstash/box": "0.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run"
+  }
+}