@pocketenv/cli 0.2.5 → 0.3.1

package/src/cmd/volume.ts

@@ -0,0 +1,123 @@
+import chalk from "chalk";
+import consola from "consola";
+import getAccessToken from "../lib/getAccessToken";
+import { client } from "../client";
+import { env } from "../lib/env";
+import type { Volume } from "../types/volume";
+import CliTable3 from "cli-table3";
+import { c } from "../theme";
+import dayjs from "dayjs";
+import relativeTime from "dayjs/plugin/relativeTime";
+
+dayjs.extend(relativeTime);
+
+export async function listVolumes(sandboxId: string) {
+  const token = await getAccessToken();
+
+  const response = await client.get<{ volumes: Volume[] }>(
+    "/xrpc/io.pocketenv.volume.getVolumes",
+    {
+      params: {
+        sandboxId,
+      },
+      headers: {
+        Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+      },
+    },
+  );
+
+  const table = new CliTable3({
+    head: [
+      c.primary("ID"),
+      c.primary("NAME"),
+      c.primary("PATH"),
+      c.primary("CREATED AT"),
+    ],
+    chars: {
+      top: "",
+      "top-mid": "",
+      "top-left": "",
+      "top-right": "",
+      bottom: "",
+      "bottom-mid": "",
+      "bottom-left": "",
+      "bottom-right": "",
+      left: "",
+      "left-mid": "",
+      mid: "",
+      "mid-mid": "",
+      right: "",
+      "right-mid": "",
+      middle: " ",
+    },
+    style: {
+      border: [],
+      head: [],
+    },
+  });
+
+  for (const volume of response.data.volumes) {
+    table.push([
+      c.secondary(volume.id),
+      volume.name,
+      volume.path,
+      dayjs(volume.createdAt).fromNow(),
+    ]);
+  }
+
+  consola.log(table.toString());
+}
+
+export async function createVolume(
+  sandbox: string,
+  name: string,
+  path: string,
+) {
+  const token = await getAccessToken();
+
+  try {
+    await client.post(
+      "/xrpc/io.pocketenv.volume.addVolume",
+      {
+        volume: {
+          sandboxId: sandbox,
+          name,
+          path,
+        },
+      },
+      {
+        headers: {
+          Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+        },
+      },
+    );
+
+    consola.success(
+      `Volume ${chalk.rgb(0, 232, 198)(name)} successfully mounted in sandbox ${chalk.rgb(0, 232, 198)(sandbox)} at path ${chalk.rgb(0, 232, 198)(path)}`,
+    );
+  } catch (error) {
+    consola.error("Failed to create volume:", error);
+  }
+}
+
+export async function deleteVolume(id: string) {
+  const token = await getAccessToken();
+
+  try {
+    await client.post(`/xrpc/io.pocketenv.volume.deleteVolume`, undefined, {
+      params: {
+        id,
+      },
+      headers: {
+        Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+      },
+    });
+  } catch (error) {
+    consola.error(`Failed to delete volume: ${error}`);
+    return;
+  }
+
+  consola.success(
+    `Volume ${chalk.rgb(0, 232, 198)(id)} successfully deleted from sandbox`,
+  );
+}

package/src/cmd/vscode.ts

@@ -0,0 +1,32 @@
+import consola from "consola";
+import getAccessToken from "../lib/getAccessToken";
+import { client } from "../client";
+import { env } from "../lib/env";
+import { c } from "../theme";
+
+export async function exposeVscode(sandbox: string) {
+  const token = await getAccessToken();
+  try {
+    const response = await client.post<{ previewUrl?: string }>(
+      `/xrpc/io.pocketenv.sandbox.exposeVscode`,
+      undefined,
+      {
+        params: {
+          id: sandbox,
+        },
+        headers: {
+          Authorization: `Bearer ${env.POCKETENV_TOKEN || token}`,
+        },
+      },
+    );
+
+    consola.success(`VS Code Server exposed for sandbox ${c.primary(sandbox)}`);
+
+    if (response.data.previewUrl) {
+      consola.success(`Preview URL: ${c.secondary(response.data.previewUrl)}`);
+    }
+  } catch (error) {
+    consola.error("Failed to expose VS Code:", error);
+    process.exit(1);
+  }
+}

package/src/index.ts

@@ -14,16 +14,15 @@ import { deleteSecret, listSecrets, putSecret } from "./cmd/secret";
 import { deleteEnv, listEnvs, putEnv } from "./cmd/env";
 import { getSshKey, putKeys } from "./cmd/sshkeys";
 import { getTailscaleAuthKey, putAuthKey } from "./cmd/tailscale";
-
-const c = {
-  primary: (s: string) => chalk.rgb(0, 232, 198)(s),
-  secondary: (s: string) => chalk.rgb(0, 198, 232)(s),
-  accent: (s: string) => chalk.rgb(130, 100, 255)(s),
-  highlight: (s: string) => chalk.rgb(100, 232, 130)(s),
-  muted: (s: string) => chalk.rgb(200, 210, 220)(s),
-  link: (s: string) => chalk.rgb(255, 160, 100)(s),
-  sky: (s: string) => chalk.rgb(0, 210, 255)(s),
-};
+import { exposePort } from "./cmd/expose";
+import { unexposePort } from "./cmd/unexpose";
+import { createVolume, deleteVolume, listVolumes } from "./cmd/volume";
+import { deleteFile, listFiles, putFile } from "./cmd/file";
+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();
 
@@ -78,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);
 
@@ -96,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,6 +119,105 @@ program
   .description("delete the given sandbox")
   .action(deleteSandbox);
 
+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)) {
+      consola.error(`port must be a number, got: ${val}`);
+      process.exit(1);
+    }
+    return port;
+  })
+  .argument("[description]", "an optional description for the exposed port")
+  .description("expose a port from the given sandbox to the internet")
+  .action(exposePort);
+
+program
+  .command("unexpose")
+  .argument("<sandbox>", "the sandbox to unexpose a port for")
+  .argument("<port>", "the port to unexpose", (val) => {
+    const port = parseInt(val, 10);
+    if (isNaN(port)) {
+      consola.error(`port must be a number, got: ${val}`);
+      process.exit(1);
+    }
+    return port;
+  })
+  .description("unexpose a port from the given sandbox")
+  .action(unexposePort);
+
+const volume = program.command("volume").description("manage volumes");
+
+volume
+  .command("put")
+  .argument("<sandbox>", "the sandbox to put the volume in")
+  .argument("<name>", "the name of the volume")
+  .argument("<path>", "the path to mount the volume at")
+  .description("put a volume in the given sandbox")
+  .action(createVolume);
+
+volume
+  .command("list")
+  .aliases(["ls"])
+  .argument("<sandbox>", "the sandbox to list volumes for")
+  .description("list volumes in the given sandbox")
+  .action(listVolumes);
+
+volume
+  .command("delete")
+  .aliases(["rm", "remove"])
+  .argument("<id>", "the ID of the volume to delete")
+  .description("delete a volume")
+  .action(deleteVolume);
+
+const file = program.command("file").description("manage files");
+
+file
+  .command("put")
+  .argument("<sandbox>", "the sandbox to put the file in")
+  .argument("<path>", "the remote path to upload the file to")
+  .argument("[localPath]", "the local path of the file to upload")
+  .description("upload a file to the given sandbox")
+  .action(putFile);
+
+file
+  .command("list")
+  .aliases(["ls"])
+  .argument("<sandbox>", "the sandbox to list files for")
+  .description("list files in the given sandbox")
+  .action(listFiles);
+
+file
+  .command("delete")
+  .aliases(["rm", "remove"])
+  .argument("<id>", "the ID of the file to delete")
+  .description("delete a file")
+  .action(deleteFile);
+
+program
+  .command("ports")
+  .argument("<sandbox>", "the sandbox to list exposed ports for")
+  .description("list exposed ports for a sandbox")
+  .action(listPorts);
+
 const secret = program.command("secret").description("manage secrets");
 
 secret

package/src/theme.ts

@@ -0,0 +1,12 @@
+import chalk from "chalk";
+
+export const c = {
+  primary: (s: string | number) => chalk.rgb(0, 232, 198)(s),
+  secondary: (s: string | number) => chalk.rgb(0, 198, 232)(s),
+  accent: (s: string | number) => chalk.rgb(130, 100, 255)(s),
+  highlight: (s: string | number) => chalk.rgb(100, 232, 130)(s),
+  muted: (s: string | number) => chalk.rgb(200, 210, 220)(s),
+  link: (s: string | number) => chalk.rgb(255, 160, 100)(s),
+  sky: (s: string | number) => chalk.rgb(0, 210, 255)(s),
+  error: (s: string | number) => chalk.rgb(255, 100, 100)(s),
+};

package/src/types/port.ts

@@ -0,0 +1,5 @@
+export type Port = {
+  port: number;
+  description?: string;
+  previewUrl?: string;
+};