@upstash/box-cli 0.0.0 → 0.1.3

package/README.md

@@ -17,10 +17,10 @@ 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:
+Provide your Upstash Box API token via the `--token` flag or the `UPSTASH_BOX_API_KEY` environment variable:
 
 ```bash
-export UPSTASH_BOX_TOKEN=abx_...
+export UPSTASH_BOX_API_KEY=abx_...
 ```
 
 ## Commands
@@ -39,14 +39,14 @@ box create \
   --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) |
+| Flag              | Description                                                              |
+| ----------------- | ------------------------------------------------------------------------ |
+| `--token`         | Upstash Box API token                                                    |
+| `--runtime`       | Runtime environment (`node`, `python`, `golang`, `ruby`, `rust`)         |
+| `--agent-model`   | Agent model identifier                                                   |
+| `--agent-api-key` | Agent API key — Anthropic or OpenAI (required if `--agent-model` is set) |
+| `--git-token`     | GitHub personal access token                                             |
+| `--env KEY=VAL`   | Environment variable (repeatable)                                        |
 
 ### `box connect [box-id]`
 
@@ -89,7 +89,7 @@ After `create`, `connect`, or `from-snapshot`, you enter an interactive REPL ses
 
 ```
 Connected to box box_abc123
-Type a prompt to run the agent, or use commands: run, exec, files, git, snapshot, stop, delete, exit
+Type a prompt to run the agent, or use commands: run, exec, files, git, snapshot, pause, delete, exit
 
 box_abc123> Fix the bug in auth.ts
 ```
@@ -98,22 +98,22 @@ box_abc123> Fix the bug in auth.ts
 
 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) |
+| 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           |
+| `pause`                        | Pause the box and exit                         |
+| `delete`                       | Delete the box and exit                        |
+| `exit`                         | Exit the REPL (box keeps running)              |
 
 ### Examples
 

package/dist/auth.d.ts

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

package/dist/auth.js

@@ -2,11 +2,13 @@
  * 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;
+  const token = flagToken ?? process.env.UPSTASH_BOX_API_KEY;
+  if (!token) {
+    console.error(
+      "Error: API token required. Use --token flag or set UPSTASH_BOX_API_KEY env var.",
+    );
+    process.exit(1);
+  }
+  return token;
 }
-//# sourceMappingURL=auth.js.map
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -1 +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"}
+{"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,mBAAmB,CAAC;IAC3D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,iFAAiF,CAAC,CAAC;QACjG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/commands/connect.d.ts

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

package/dist/commands/connect.js

@@ -2,20 +2,20 @@ 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;
+  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);
     }
-    console.log(`Connecting to box ${targetId}...`);
-    const box = await Box.get(targetId, { apiKey });
-    await startRepl(box);
+    targetId = boxes[0].id;
+  }
+  console.log(`Connecting to box ${targetId}...`);
+  const box = await Box.get(targetId, { apiKey });
+  await startRepl(box);
 }
-//# sourceMappingURL=connect.js.map
+//# sourceMappingURL=connect.js.map

package/dist/commands/create.d.ts

@@ -1,11 +1,11 @@
 interface CreateFlags {
-    token?: string;
-    runtime?: string;
-    agentModel?: string;
-    agentApiKey?: string;
-    gitToken?: string;
-    env?: string[];
+  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
+//# sourceMappingURL=create.d.ts.map

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

@@ -1 +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"}
+{"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,CA8BrE"}

package/dist/commands/create.js

@@ -2,34 +2,33 @@ 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");
+  const apiKey = resolveToken(flags.token);
+  if (flags.agentModel && !flags.agentApiKey) {
+    console.error("Error: --agent-api-key is required if --agent-model is set");
+    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);
     }
-    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);
+  }
+  console.log("Creating box...");
+  const box = await Box.create({
+    apiKey,
+    runtime: flags.runtime,
+    agent:
+      flags.agentModel && flags.agentApiKey
+        ? { model: flags.agentModel, apiKey: flags.agentApiKey }
+        : undefined,
+    git: flags.gitToken ? { token: flags.gitToken } : undefined,
+    env: Object.keys(env).length > 0 ? env : undefined,
+  });
+  await startRepl(box);
 }
-//# sourceMappingURL=create.js.map
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

@@ -1 +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"}
+{"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,KAAK,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAC3C,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAC5E,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,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;QACnH,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

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

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

@@ -1 +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"}
+{"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,CA8BrG"}

package/dist/commands/from-snapshot.js

@@ -2,34 +2,33 @@ 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");
+  const apiKey = resolveToken(flags.token);
+  if (flags.agentModel && !flags.agentApiKey) {
+    console.error("Error: --agent-api-key is required if --agent-model is set");
+    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);
     }
-    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);
+  }
+  console.log("Creating box from snapshot...");
+  const box = await Box.fromSnapshot(snapshotId, {
+    apiKey,
+    runtime: flags.runtime,
+    agent:
+      flags.agentModel && flags.agentApiKey
+        ? { model: flags.agentModel, apiKey: flags.agentApiKey }
+        : undefined,
+    git: flags.gitToken ? { token: flags.gitToken } : undefined,
+    env: Object.keys(env).length > 0 ? env : undefined,
+  });
+  await startRepl(box);
 }
-//# sourceMappingURL=from-snapshot.js.map
+//# sourceMappingURL=from-snapshot.js.map

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

@@ -1 +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"}
+{"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,KAAK,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAC3C,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAC5E,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,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;QACnH,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

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

package/dist/commands/get.js

@@ -2,8 +2,8 @@ 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 }));
+  const apiKey = resolveToken(flags.token);
+  const box = await Box.get(boxId, { apiKey });
+  console.log(formatJSON({ id: box.id }));
 }
-//# sourceMappingURL=get.js.map
+//# sourceMappingURL=get.js.map

package/dist/commands/list.d.ts

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

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

@@ -1 +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"}
+{"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,CAuBjE"}

package/dist/commands/list.js

@@ -1,14 +1,19 @@
 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}`);
-    }
+  const apiKey = resolveToken(flags.token);
+  const boxes = await Box.list({ apiKey });
+  if (boxes.length === 0) {
+    console.log("No boxes found.");
+    return;
+  }
+  const headers = ["ID", "STATUS", "MODEL", "CREATED"];
+  const rows = boxes.map((b) => [b.id, b.status, b.model ?? "", String(b.created_at)]);
+  const colWidths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
+  const formatRow = (row) => row.map((val, i) => val.padEnd(colWidths[i])).join("  ");
+  console.log(formatRow(headers));
+  for (const row of rows) {
+    console.log(formatRow(row));
+  }
 }
-//# sourceMappingURL=list.js.map
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

@@ -1 +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"}
+{"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,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAErF,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACrC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC,CACrD,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,GAAa,EAAE,EAAE,CAClC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5D,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/index.d.ts

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

package/dist/index.js

@@ -8,43 +8,43 @@ 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");
+  .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));
+  .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));
+  .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));
+  .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));
+  .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));
+  .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
+//# sourceMappingURL=index.js.map

package/dist/output.d.ts

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

package/dist/output.js

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

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

@@ -3,4 +3,4 @@ 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
+//# sourceMappingURL=delete.d.ts.map

package/dist/repl-commands/delete.js

@@ -2,8 +2,8 @@
  * 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;
+  await box.delete();
+  console.log(`Box ${box.id} deleted.`);
+  return true;
 }
-//# sourceMappingURL=delete.js.map
+//# sourceMappingURL=delete.js.map

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

@@ -3,4 +3,4 @@ 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
+//# sourceMappingURL=exec.d.ts.map

package/dist/repl-commands/exec.js

@@ -2,13 +2,12 @@
  * 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);
+  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
+//# sourceMappingURL=exec.js.map

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

@@ -3,4 +3,4 @@ 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
+//# sourceMappingURL=files.d.ts.map

package/dist/repl-commands/files.js

@@ -2,58 +2,58 @@
  * 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...]");
+  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
+//# sourceMappingURL=files.js.map

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

@@ -3,4 +3,4 @@ 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
+//# sourceMappingURL=git.d.ts.map

package/dist/repl-commands/git.js

@@ -2,37 +2,37 @@
  * 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...]");
+  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
+//# sourceMappingURL=git.js.map

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

@@ -3,4 +3,4 @@ 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
+//# sourceMappingURL=run.d.ts.map

package/dist/repl-commands/run.js

@@ -2,13 +2,13 @@
  * 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();
+  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
+//# sourceMappingURL=run.js.map

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

@@ -3,4 +3,4 @@ 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
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/repl-commands/snapshot.js

@@ -2,8 +2,8 @@
  * 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})`);
+  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
+//# sourceMappingURL=snapshot.js.map

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

@@ -3,4 +3,4 @@ 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
+//# sourceMappingURL=stop.d.ts.map

package/dist/repl-commands/stop.js

@@ -2,8 +2,8 @@
  * 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;
+  await box.stop();
+  console.log(`Box ${box.id} stopped.`);
+  return true;
 }
-//# sourceMappingURL=stop.js.map
+//# sourceMappingURL=stop.js.map

package/dist/repl.d.ts

@@ -3,4 +3,4 @@ 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
+//# sourceMappingURL=repl.d.ts.map

package/dist/repl.js

@@ -8,61 +8,57 @@ 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,
+  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}`);
-                }
-            }
+  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();
-    }
+  } finally {
+    rl.close();
+  }
 }
-//# sourceMappingURL=repl.js.map
+//# sourceMappingURL=repl.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upstash/box-cli",
-  "version": "0.0.0",
+  "version": "0.1.3",
   "description": "CLI for Upstash Box — REPL-first interface for AI coding agents",
   "type": "module",
   "bin": {
@@ -18,10 +18,11 @@
   "dependencies": {
     "commander": "^13.0.0",
     "dotenv": "^17.3.1",
-    "@upstash/box": "0.0.0"
+    "@upstash/box": "0.1.2"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",
+    "prettier": "^3.8.1",
     "typescript": "^5.3.0"
   },
   "publishConfig": {
@@ -36,6 +37,7 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "test": "vitest run"
+    "test": "vitest run",
+    "lint": "prettier --check . --write"
   }
 }