@pocketenv/cli 0.3.0 → 0.3.2

package/dist/index.js

@@ -22,7 +22,7 @@ import relativeTime from 'dayjs/plugin/relativeTime.js';
 import { password, editor, input } from '@inquirer/prompts';
 import sodium from 'libsodium-wrappers';
 
-var version = "0.3.0";
+var version = "0.3.2";
 
 async function getAccessToken() {
   const tokenPath = path.join(os.homedir(), ".pocketenv", "token.json");
@@ -410,17 +410,32 @@ async function ssh(sandboxName) {
   }
 }
 
-async function start(name, { ssh: ssh$1 }) {
+function expandRepo(repo) {
+  const githubMatch = repo.match(/^github:([^/]+\/[^/]+)$/);
+  if (githubMatch) return `https://github.com/${githubMatch[1]}`;
+  const tangledMatch = repo.match(/^tangled:([^/]+\/[^/]+)$/);
+  if (tangledMatch) return `https://tangled.org/${tangledMatch[1]}`;
+  return repo;
+}
+
+async function start(name, { ssh: ssh$1, repo }) {
   const token = await getAccessToken();
+  if (repo) repo = expandRepo(repo);
   try {
-    await client.post("/xrpc/io.pocketenv.sandbox.startSandbox", void 0, {
-      params: {
-        id: name
+    await client.post(
+      "/xrpc/io.pocketenv.sandbox.startSandbox",
+      {
+        repo
       },
-      headers: {
-        Authorization: `Bearer ${env$1.POCKETENV_TOKEN || token}`
+      {
+        params: {
+          id: name
+        },
+        headers: {
+          Authorization: `Bearer ${env$1.POCKETENV_TOKEN || token}`
+        }
       }
-    });
+    );
     if (ssh$1) {
       await ssh(name);
       return;
@@ -572,9 +587,11 @@ async function stop(name) {
 async function createSandbox(name, {
   provider,
   ssh: ssh$1,
-  base
+  base,
+  repo
 }) {
   const token = await getAccessToken();
+  if (repo) repo = expandRepo(repo);
   if (["deno", "vercel", "daytona"].includes(provider || "")) {
     consola.error(
       `This Sandbox Runtime is temporarily disabled. ${c.primary(provider ?? "")}`
@@ -587,7 +604,8 @@ async function createSandbox(name, {
       {
         name,
         base: base ?? "at://did:plc:aturpi2ls3yvsmhc6wybomun/io.pocketenv.sandbox/openclaw",
-        provider: provider ?? "cloudflare"
+        provider: provider ?? "cloudflare",
+        repo
       },
       {
         headers: {
@@ -1516,6 +1534,43 @@ async function exposeVscode(sandbox) {
   }
 }
 
+async function exec(sandbox, command) {
+  const token = await getAccessToken();
+  try {
+    const [cmd, ...args] = command;
+    const response = await client.post(
+      "/xrpc/io.pocketenv.sandbox.exec",
+      {
+        command: `${cmd} ${args.join(" ")}`
+      },
+      {
+        params: {
+          id: sandbox
+        },
+        headers: {
+          Authorization: `Bearer ${env$1.POCKETENV_TOKEN || token}`
+        }
+      }
+    );
+    if (response.data.stdout) {
+      process.stdout.write(
+        response.data.stdout.endsWith("\n") ? response.data.stdout : response.data.stdout + "\n"
+      );
+    }
+    if (response.data.stderr) {
+      process.stderr.write(
+        response.data.stderr.endsWith("\n") ? response.data.stderr : response.data.stderr + "\n"
+      );
+    }
+    if (response.data.exitCode !== 0) {
+      consola.error(`Command exited with code ${response.data.exitCode}`);
+    }
+    process.exit(response.data.exitCode);
+  } catch (error) {
+    consola.error("Failed to execute command:", error);
+  }
+}
+
 const program = new Command();
 program.name("pocketenv").description(
   `${chalk.bold.rgb(0, 232, 198)(`pocketenv v${version}`)} ${c.muted("\u2500")} ${c.muted("Open, interoperable sandbox platform for agents and humans")}`
@@ -1542,17 +1597,22 @@ program.command("login").argument("<handle>", "your AT Proto handle (e.g., <user
 program.command("whoami").description("get the current logged-in user").action(whoami);
 program.command("console").aliases(["shell", "ssh", "s"]).argument("[sandbox]", "the sandbox to connect to").description("open an interactive shell for the given sandbox").action(ssh);
 program.command("ls").description("list sandboxes").action(listSandboxes);
-program.command("start").argument("<sandbox>", "the sandbox to start").option("--ssh, -s", "connect to the Sandbox and automatically open a shell").description("start the given sandbox").action(start);
+program.command("start").argument("<sandbox>", "the sandbox to start").option("--ssh, -s", "connect to the Sandbox and automatically open a shell").option(
+  "--repo, -r <repo>",
+  "the repository to clone into the sandbox (e.g., github:user/repo, tangled:user/repo, or a Git URL)"
+).description("start the given sandbox").action(start);
 program.command("stop").argument("<sandbox>", "the sandbox to stop").description("stop the given sandbox").action(stop);
 program.command("create").aliases(["new"]).option("--provider, -p <provider>", "the provider to use for the sandbox").option(
   "--base, -b <base>",
   "the base sandbox to use for the sandbox, e.g. openclaw, claude-code, codex, copilot ..."
-).option("--ssh, -s", "connect to the Sandbox and automatically open a shell").argument("[name]", "the name of the sandbox to create").description("create a new sandbox").action(createSandbox);
+).option("--ssh, -s", "connect to the Sandbox and automatically open a shell").option(
+  "--repo, -r <repo>",
+  "the repository to clone into the sandbox (e.g., github:user/repo, tangled:user/repo, or a Git URL)"
+).argument("[name]", "the name of the sandbox to create").description("create a new sandbox").action(createSandbox);
 program.command("logout").description("logout (removes session token)").action(logout);
 program.command("rm").aliases(["delete", "remove"]).argument("<sandbox>", "the sandbox to delete").description("delete the given sandbox").action(deleteSandbox);
-program.command("vscode").argument("<sandbox>", "the sandbox to expose VS Code for").description(
-  "expose a VS Code Server instance running in the given sandbox to the internet"
-).action(exposeVscode);
+program.command("vscode").aliases(["code", "code-server"]).argument("<sandbox>", "the sandbox to expose VS Code for").description("expose a visual code server to the internet").action(exposeVscode);
+program.enablePositionalOptions().command("exec").argument("<sandbox>", "the sandbox to execute the command in").argument("<command...>", "the command to execute").description("execute a command in the given sandbox").passThroughOptions().action(exec);
 program.command("expose").argument("<sandbox>", "the sandbox to expose a port for").argument("<port>", "the port to expose", (val) => {
   const port = parseInt(val, 10);
   if (isNaN(port)) {

package/package.json

@@ -4,7 +4,7 @@
   "bin": {
     "pocketenv": "dist/index.js"
   },
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "keywords": [
     "sandbox",

package/src/cmd/create.ts

@@ -4,6 +4,7 @@ import getAccessToken from "../lib/getAccessToken";
 import type { Sandbox } from "../types/sandbox";
 import connectToSandbox from "./ssh";
 import { c } from "../theme";
+import { expandRepo } from "../lib/expandRepo";
 
 async function createSandbox(
   name: string,
@@ -11,13 +12,16 @@ async function createSandbox(
     provider,
     ssh,
     base,
+    repo,
   }: {
-    provider: string | undefined;
-    ssh: boolean | undefined;
-    base: string | undefined;
+    provider?: string;
+    ssh?: boolean;
+    base?: string;
+    repo?: string;
   },
 ) {
   const token = await getAccessToken();
+  if (repo) repo = expandRepo(repo);
 
   if (["deno", "vercel", "daytona"].includes(provider || "")) {
     consola.error(
@@ -34,6 +38,7 @@ async function createSandbox(
           base ??
           "at://did:plc:aturpi2ls3yvsmhc6wybomun/io.pocketenv.sandbox/openclaw",
         provider: provider ?? "cloudflare",
+        repo,
       },
       {
         headers: {

package/src/cmd/exec.ts

@@ -0,0 +1,53 @@
+import consola from "consola";
+import getAccessToken from "../lib/getAccessToken";
+import { client } from "../client";
+import { env } from "../lib/env";
+
+export async function exec(sandbox: string, command: string[]) {
+  const token = await getAccessToken();
+
+  try {
+    const [cmd, ...args] = command;
+    const response = await client.post<{
+      stderr: string;
+      stdout: string;
+      exitCode: number;
+    }>(
+      "/xrpc/io.pocketenv.sandbox.exec",
+      {
+        command: `${cmd} ${args.join(" ")}`,
+      },
+      {
+        params: {
+          id: sandbox,
+        },
+        headers: {
+          Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+        },
+      },
+    );
+
+    if (response.data.stdout) {
+      process.stdout.write(
+        response.data.stdout.endsWith("\n")
+          ? response.data.stdout
+          : response.data.stdout + "\n",
+      );
+    }
+    if (response.data.stderr) {
+      process.stderr.write(
+        response.data.stderr.endsWith("\n")
+          ? response.data.stderr
+          : response.data.stderr + "\n",
+      );
+    }
+
+    if (response.data.exitCode !== 0) {
+      consola.error(`Command exited with code ${response.data.exitCode}`);
+    }
+
+    process.exit(response.data.exitCode);
+  } catch (error) {
+    consola.error("Failed to execute command:", error);
+  }
+}

package/src/cmd/start.ts

@@ -4,19 +4,30 @@ import getAccessToken from "../lib/getAccessToken";
 import { client } from "../client";
 import { env } from "../lib/env";
 import connectToSandbox from "./ssh";
+import { expandRepo } from "../lib/expandRepo";
 
-async function start(name: string, { ssh }: { ssh?: boolean }) {
+async function start(
+  name: string,
+  { ssh, repo }: { ssh?: boolean; repo?: string },
+) {
   const token = await getAccessToken();
+  if (repo) repo = expandRepo(repo);
 
   try {
-    await client.post("/xrpc/io.pocketenv.sandbox.startSandbox", undefined, {
-      params: {
-        id: name,
+    await client.post(
+      "/xrpc/io.pocketenv.sandbox.startSandbox",
+      {
+        repo,
       },
-      headers: {
-        Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+      {
+        params: {
+          id: name,
+        },
+        headers: {
+          Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+        },
       },
-    });
+    );
 
     if (ssh) {
       await connectToSandbox(name);

package/src/index.ts

@@ -22,6 +22,7 @@ import consola from "consola";
 import { listPorts } from "./cmd/ports";
 import { c } from "./theme";
 import { exposeVscode } from "./cmd/vscode";
+import { exec } from "./cmd/exec";
 
 const program = new Command();
 
@@ -76,6 +77,10 @@ program
   .command("start")
   .argument("<sandbox>", "the sandbox to start")
   .option("--ssh, -s", "connect to the Sandbox and automatically open a shell")
+  .option(
+    "--repo, -r <repo>",
+    "the repository to clone into the sandbox (e.g., github:user/repo, tangled:user/repo, or a Git URL)",
+  )
   .description("start the given sandbox")
   .action(start);
 
@@ -94,6 +99,10 @@ program
     "the base sandbox to use for the sandbox, e.g. openclaw, claude-code, codex, copilot ...",
   )
   .option("--ssh, -s", "connect to the Sandbox and automatically open a shell")
+  .option(
+    "--repo, -r <repo>",
+    "the repository to clone into the sandbox (e.g., github:user/repo, tangled:user/repo, or a Git URL)",
+  )
   .argument("[name]", "the name of the sandbox to create")
   .description("create a new sandbox")
   .action(createSandbox);
@@ -112,12 +121,20 @@ program
 
 program
   .command("vscode")
+  .aliases(["code", "code-server"])
   .argument("<sandbox>", "the sandbox to expose VS Code for")
-  .description(
-    "expose a VS Code Server instance running in the given sandbox to the internet",
-  )
+  .description("expose a visual code server to the internet")
   .action(exposeVscode);
 
+program
+  .enablePositionalOptions()
+  .command("exec")
+  .argument("<sandbox>", "the sandbox to execute the command in")
+  .argument("<command...>", "the command to execute")
+  .description("execute a command in the given sandbox")
+  .passThroughOptions()
+  .action(exec);
+
 program
   .command("expose")
   .argument("<sandbox>", "the sandbox to expose a port for")

package/src/lib/expandRepo.ts

@@ -0,0 +1,9 @@
+export function expandRepo(repo: string): string {
+  const githubMatch = repo.match(/^github:([^/]+\/[^/]+)$/);
+  if (githubMatch) return `https://github.com/${githubMatch[1]}`;
+
+  const tangledMatch = repo.match(/^tangled:([^/]+\/[^/]+)$/);
+  if (tangledMatch) return `https://tangled.org/${tangledMatch[1]}`;
+
+  return repo;
+}