totopo 0.6.1 → 0.7.0-rc-2

package/README.md

@@ -112,6 +112,12 @@ git push / pull / fetch
 
 ---
 
+## Limitations
+
+**No audio / microphone support** — the container has no access to host audio devices. Features that require microphone input (e.g. Claude Code's `/voice` mode) will not work inside the container.
+
+---
+
 ## Troubleshooting
 
 **Container fails to start** — the startup check prints exactly which check failed and why.

package/bin/totopo.js

@@ -47,13 +47,14 @@ process.env.TOTOPO_REPO_ROOT = repoRoot;
 // ─── Auto-install dependencies ────────────────────────────────────────────────
 const tsx = join(packageDir, "node_modules/.bin/tsx");
 if (!existsSync(tsx)) {
-    console.log("  Installing totopo dependencies...");
+    process.stdout.write("  Getting ready…");
     let pm = "npm";
     try {
         execSync("which pnpm", { stdio: "ignore" });
         pm = "pnpm";
     } catch {}
     execSync(`${pm} install --silent`, { cwd: packageDir, stdio: "inherit" });
+    process.stdout.write("\r\x1b[2K"); // clear the line
 }
 
 // ─── Helper ───────────────────────────────────────────────────────────────────
@@ -84,6 +85,20 @@ const dockerResult = spawnSync("docker", ["ps", "--filter", "name=totopo-managed
 });
 const activeCount = dockerResult.stdout ? dockerResult.stdout.trim().split("\n").filter(Boolean).length : 0;
 
+// Is THIS project's container running?
+const projectContainerResult = spawnSync("docker", ["ps", "--filter", `name=totopo-managed-${projectName}`, "--format", "{{.Names}}"], {
+    encoding: "utf8",
+});
+const projectRunning = (projectContainerResult.stdout ?? "")
+    .trim()
+    .split("\n")
+    .filter(Boolean)
+    .some((n) => n === `totopo-managed-${projectName}`);
+
+// Does THIS project's image exist?
+const projectImageResult = spawnSync("docker", ["images", "-q", `totopo-managed-${projectName}`], { encoding: "utf8" });
+const projectImageExists = (projectImageResult.stdout ?? "").trim().length > 0;
+
 let hasKey = false;
 const envPath = join(repoRoot, ".totopo/.env");
 if (existsSync(envPath)) {
@@ -102,29 +117,52 @@ if (existsSync(envPath)) {
 // stdout → /dev/tty so the clack UI renders on the terminal
 // stderr → pipe so the selected action string is captured
 const ttyFd = openSync("/dev/tty", "w");
-const menuResult = spawnSync(tsx, [join(packageDir, "src/core/commands/menu.ts"), projectName, String(activeCount), String(hasKey)], {
-    stdio: ["inherit", ttyFd, "pipe"],
-    encoding: "utf8",
-});
-const action = (menuResult.stderr ?? "").trim();
-
-// ─── Execute selection ────────────────────────────────────────────────────────
-switch (action) {
-    case "dev":
-        run("dev.ts");
-        break;
-    case "stop":
-        run("stop.ts");
-        break;
-    case "reset":
-        run("reset.ts");
-        break;
-    case "doctor":
-        run("doctor.ts", ["--verbose"]);
-        break;
-    case "settings":
-        run("settings.ts");
-        break;
-    default:
-        break; // quit or cancelled
+
+let showMenu = true;
+while (showMenu) {
+    showMenu = false;
+
+    const menuResult = spawnSync(
+        tsx,
+        [
+            join(packageDir, "src/core/commands/menu.ts"),
+            projectName,
+            String(activeCount),
+            String(hasKey),
+            String(projectRunning),
+            String(projectImageExists),
+        ],
+        {
+            stdio: ["inherit", ttyFd, "pipe"],
+            encoding: "utf8",
+        },
+    );
+    const action = (menuResult.stderr ?? "").trim();
+
+    // ─── Execute selection ────────────────────────────────────────────────────────
+    switch (action) {
+        case "dev":
+            run("dev.ts");
+            break;
+        case "stop":
+            run("stop.ts", [projectName]);
+            break;
+        case "rebuild":
+            run("rebuild.ts", [projectName]);
+            run("dev.ts");
+            break;
+        case "manage": {
+            const result = run("manage.ts", [projectName]);
+            if (result.status === 2) showMenu = true; // Back selected
+            break;
+        }
+        case "doctor":
+            run("doctor.ts", ["--verbose"]);
+            break;
+        case "settings":
+            run("settings.ts");
+            break;
+        default:
+            break; // quit or cancelled
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "totopo",
-  "version": "0.6.1",
+  "version": "0.7.0-rc-2",
   "description": "Secure AI Box — isolated dev environments for AI coding assistants",
   "type": "module",
   "bin": {

package/src/core/commands/manage.ts

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+// =========================================================================================================================================
+// src/core/commands/manage.ts — Manage workspaces submenu
+// Invoked by bin/totopo.js — do not run directly.
+// =========================================================================================================================================
+
+import { spawnSync } from "node:child_process";
+import { rmSync } from "node:fs";
+import { join } from "node:path";
+import { cancel, confirm, isCancel, log, multiselect, outro, select } from "@clack/prompts";
+
+const [projectName = "unknown"] = process.argv.slice(2);
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function stopAndRemoveContainer(name: string) {
+    spawnSync("docker", ["stop", name], { stdio: "inherit" });
+    spawnSync("docker", ["rm", name], { stdio: "inherit" });
+}
+
+// ─── Submenu ─────────────────────────────────────────────────────────────────
+const action = await select({
+    message: "Manage workspaces:",
+    options: [
+        { value: "stop-containers", label: "Stop running containers" },
+        { value: "remove-images", label: "Remove images" },
+        { value: "uninstall", label: "Uninstall from this project" },
+        { value: "back", label: "← Back" },
+    ],
+});
+
+if (isCancel(action) || action === "back") {
+    process.exit(2); // 2 = "back" signal to bin/totopo.js
+}
+
+// ─── A: Stop running containers ───────────────────────────────────────────────
+if (action === "stop-containers") {
+    const listResult = spawnSync("docker", ["ps", "--filter", "name=totopo-managed-", "--format", "{{.Names}}"], { encoding: "utf8" });
+    const running = (listResult.stdout ?? "").trim().split("\n").filter(Boolean);
+
+    if (running.length === 0) {
+        log.info("No running containers.");
+        process.exit(0);
+    }
+
+    let toStop: string[];
+    if (running.length === 1) {
+        toStop = running;
+        log.info(`Stopping ${running[0]}...`);
+    } else {
+        const selected = await multiselect({
+            message: "Select containers to stop:",
+            options: running.map((name) => ({ value: name, label: name })),
+            required: false,
+        });
+        if (isCancel(selected)) {
+            cancel();
+            process.exit(0);
+        }
+        toStop = selected as string[];
+    }
+
+    for (const name of toStop) {
+        log.step(`Stopping ${name}...`);
+        stopAndRemoveContainer(name);
+    }
+    outro("Done.");
+}
+
+// ─── B: Remove images ─────────────────────────────────────────────────────────
+else if (action === "remove-images") {
+    const listResult = spawnSync("docker", ["images", "--filter", "label=totopo.managed=true", "--format", "{{.Repository}}\t{{.ID}}"], {
+        encoding: "utf8",
+    });
+    const lines = (listResult.stdout ?? "").trim().split("\n").filter(Boolean);
+
+    if (lines.length === 0) {
+        log.info("No images found.");
+        process.exit(0);
+    }
+
+    const images = lines.map((line) => {
+        const [repo, id] = line.split("\t");
+        const workspace = (repo ?? "").replace(/^totopo-managed-/, "");
+        return { repo: repo ?? "", id: id ?? "", workspace };
+    });
+
+    const selected = await multiselect({
+        message: "Select images to remove:",
+        options: images.map((img) => ({
+            value: img.repo,
+            label: `${img.workspace}  (${img.repo})`,
+        })),
+        required: false,
+    });
+
+    if (isCancel(selected)) {
+        cancel();
+        process.exit(0);
+    }
+
+    const toRemove = selected as string[];
+
+    for (const repo of toRemove) {
+        // Stop any running container that uses this image
+        const psResult = spawnSync("docker", ["ps", "--filter", `name=${repo}`, "--format", "{{.Names}}"], { encoding: "utf8" });
+        const containers = (psResult.stdout ?? "").trim().split("\n").filter(Boolean);
+        for (const c of containers) {
+            log.step(`Stopping container ${c} before removing image...`);
+            stopAndRemoveContainer(c);
+        }
+        log.step(`Removing image ${repo}...`);
+        spawnSync("docker", ["rmi", repo], { stdio: "inherit" });
+    }
+    outro("Done.");
+}
+
+// ─── C: Uninstall from this project ───────────────────────────────────────────
+else if (action === "uninstall") {
+    const repoRoot = process.env.TOTOPO_REPO_ROOT ?? process.cwd();
+    const containerName = `totopo-managed-${projectName}`;
+    const imageName = `totopo-managed-${projectName}`;
+
+    const confirmed = await confirm({
+        message: `Remove .totopo/, stop containers, and delete the image for ${projectName}?`,
+    });
+
+    if (isCancel(confirmed) || !confirmed) {
+        cancel();
+        process.exit(0);
+    }
+
+    // Stop container if running
+    const inspectResult = spawnSync("docker", ["inspect", "--type", "container", containerName], { encoding: "utf8" });
+    if (inspectResult.status === 0) {
+        log.step(`Stopping container ${containerName}...`);
+        stopAndRemoveContainer(containerName);
+    }
+
+    // Remove image if exists
+    const imageResult = spawnSync("docker", ["images", "-q", imageName], { encoding: "utf8" });
+    if ((imageResult.stdout ?? "").trim().length > 0) {
+        log.step(`Removing image ${imageName}...`);
+        spawnSync("docker", ["rmi", imageName], { stdio: "inherit" });
+    }
+
+    // Delete .totopo/
+    log.step("Removing .totopo/...");
+    rmSync(join(repoRoot, ".totopo"), { recursive: true, force: true });
+
+    outro("Uninstalled. Re-run npx totopo to set up again.");
+}

package/src/core/commands/menu.ts

@@ -6,10 +6,12 @@
 
 import { box, cancel, isCancel, select } from "@clack/prompts";
 
-// Parse CLI args passed by ai.sh: project name, active container count, and API key presence flag
-const [projectName = "unknown", activeCountStr, hasKeyStr] = process.argv.slice(2);
+// Parse CLI args passed by bin/totopo.js: project name, active container count, API key presence, project state
+const [projectName = "unknown", activeCountStr, hasKeyStr, projectRunningStr, projectImageExistsStr] = process.argv.slice(2);
 const activeCount = Number.parseInt(activeCountStr ?? "0", 10);
 const hasKey = hasKeyStr === "true";
+const projectRunning = projectRunningStr === "true";
+const projectImageExists = projectImageExistsStr === "true";
 
 // ─── Status box ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
 const sessionLabel = activeCount === 1 ? "1 container running" : `${activeCount} containers running`;
@@ -28,8 +30,9 @@ const action = await select({
     message: "Menu:",
     options: [
         { value: "dev", label: "Start session" },
-        { value: "stop", label: "Stop all" },
-        { value: "reset", label: "Reset (wipe workspaces + images)" },
+        ...(projectRunning ? [{ value: "stop", label: "Stop" }] : []),
+        ...(projectImageExists ? [{ value: "rebuild", label: "Rebuild" }] : []),
+        { value: "manage", label: "Manage workspaces" },
         { value: "doctor", label: "Doctor" },
         { value: "settings", label: "Settings" },
         { value: "quit", label: "Quit" },

package/src/core/commands/rebuild.ts

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+// =========================================================================================================================================
+// src/core/commands/rebuild.ts — Stop this project's container and remove its image to force a fresh build
+// Invoked by bin/totopo.js — do not run directly.
+// =========================================================================================================================================
+
+import { spawnSync } from "node:child_process";
+import { log } from "@clack/prompts";
+
+const [projectName = "unknown"] = process.argv.slice(2);
+const containerName = `totopo-managed-${projectName}`;
+const imageName = `totopo-managed-${projectName}`;
+
+// ─── Stop container if running ────────────────────────────────────────────────
+const inspectResult = spawnSync("docker", ["inspect", "--type", "container", containerName], { encoding: "utf8" });
+if (inspectResult.status === 0) {
+    log.step(`Stopping container ${containerName}...`);
+    spawnSync("docker", ["stop", containerName], { stdio: "inherit" });
+    spawnSync("docker", ["rm", containerName], { stdio: "inherit" });
+}
+
+// ─── Remove image ─────────────────────────────────────────────────────────────
+const imageResult = spawnSync("docker", ["images", "-q", imageName], { encoding: "utf8" });
+if ((imageResult.stdout ?? "").trim().length > 0) {
+    log.step(`Removing image ${imageName}...`);
+    spawnSync("docker", ["rmi", imageName], { stdio: "inherit" });
+}
+
+log.info("Image removed — starting fresh build…");

package/src/core/commands/stop.ts

@@ -1,29 +1,34 @@
 #!/usr/bin/env node
 // =========================================================================================================================================
-// src/core/commands/stop.ts — Stop and remove all totopo dev containers
+// src/core/commands/stop.ts — Stop and remove THIS project's dev container
 // Invoked by bin/totopo.js — do not run directly.
 // =========================================================================================================================================
 
 import { spawnSync } from "node:child_process";
-import { log, outro } from "@clack/prompts";
+import { cancel, confirm, isCancel, log, outro } from "@clack/prompts";
 
-// ─── Find all totopo-managed-* containers ────────────────────────────────────
-const listResult = spawnSync("docker", ["ps", "-a", "--filter", "name=totopo-managed-", "--format", "{{.Names}}"], { encoding: "utf8" });
+const [projectName = "unknown"] = process.argv.slice(2);
+const containerName = `totopo-managed-${projectName}`;
 
-const containers = (listResult.stdout ?? "").trim().split("\n").filter(Boolean);
+// ─── Check if container exists ────────────────────────────────────────────────
+const inspectResult = spawnSync("docker", ["inspect", "--type", "container", containerName], { encoding: "utf8" });
 
-if (containers.length === 0) {
-    log.info("No totopo containers found.");
+if (inspectResult.status !== 0) {
+    log.info(`Container ${containerName} is not running.`);
     process.exit(0);
 }
 
-// ─── Stop and remove each container ──────────────────────────────────────────
-log.step("Stopping all totopo containers...");
+// ─── Confirm ─────────────────────────────────────────────────────────────────
+const confirmed = await confirm({ message: `Stop ${containerName}?` });
 
-for (const name of containers) {
-    log.step(`Stopping ${name}...`);
-    spawnSync("docker", ["stop", name], { stdio: "inherit" });
-    spawnSync("docker", ["rm", name], { stdio: "inherit" });
+if (isCancel(confirmed) || !confirmed) {
+    cancel();
+    process.exit(0);
 }
 
-outro("All totopo containers stopped and removed.");
+// ─── Stop and remove ─────────────────────────────────────────────────────────
+log.step(`Stopping ${containerName}...`);
+spawnSync("docker", ["stop", containerName], { stdio: "inherit" });
+spawnSync("docker", ["rm", containerName], { stdio: "inherit" });
+
+outro(`${containerName} stopped and removed.`);

package/src/core/lib/generate-dockerfile.ts

@@ -69,7 +69,7 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
     # Build essentials (needed for Rust compilation, C extensions, etc.)
     build-essential pkg-config libssl-dev \
     # Utilities
-    jq unzip zip tree htop procps lsb-release gnupg ca-certificates \
+    jq unzip zip tree htop procps lsb-release gnupg ca-certificates sox \
     # Modern search/navigation tools
     ripgrep fzf \
     # Database clients

package/templates/Dockerfile

@@ -17,7 +17,7 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
     # Build essentials (needed for Rust compilation, C extensions, etc.)
     build-essential pkg-config libssl-dev \
     # Utilities
-    jq unzip zip tree htop procps lsb-release gnupg ca-certificates \
+    jq unzip zip tree htop procps lsb-release gnupg ca-certificates sox \
     # Modern search/navigation tools
     ripgrep fzf \
     # Database clients

package/src/core/commands/reset.ts

@@ -1,46 +0,0 @@
-#!/usr/bin/env node
-// =========================================================================================================================================
-// src/core/commands/reset.ts — Full reset: delete all totopo containers and Docker images
-// Invoked by bin/totopo.js — do not run directly.
-// Run 'npx totopo' → Start session after this to get a fresh build.
-// =========================================================================================================================================
-
-import { spawnSync } from "node:child_process";
-import { log, outro } from "@clack/prompts";
-
-// ─── Step 1: Find all totopo-managed-* containers ────────────────────────────
-const listResult = spawnSync("docker", ["ps", "-a", "--filter", "name=totopo-managed-", "--format", "{{.Names}}"], { encoding: "utf8" });
-
-const containers = (listResult.stdout ?? "").trim().split("\n").filter(Boolean);
-
-// ─── Step 2: Stop and remove all totopo containers ───────────────────────────
-if (containers.length === 0) {
-    log.info("No totopo containers found.");
-} else {
-    log.step(`Stopping and removing ${containers.length} container(s)...`);
-    for (const name of containers) {
-        log.step(`  Removing ${name}...`);
-        spawnSync("docker", ["stop", name], { stdio: "inherit" });
-        spawnSync("docker", ["rm", name], { stdio: "inherit" });
-    }
-}
-
-// ─── Step 3: Remove cached Docker images ─────────────────────────────────────
-// Images are identified via the LABEL totopo.managed=true baked into the
-// Dockerfile template — works regardless of whether containers still exist.
-log.step("Removing cached Docker images...");
-
-const findImages = spawnSync("docker", ["images", "--filter", "label=totopo.managed=true", "--format", "{{.ID}}"], { encoding: "utf8" });
-const imageIds = (findImages.stdout ?? "").trim().split("\n").filter(Boolean);
-
-if (imageIds.length > 0) {
-    log.info(`  Found ${imageIds.length} image(s) — removing...`);
-    spawnSync("docker", ["rmi", "--force", ...imageIds], { stdio: "inherit" });
-} else {
-    log.info("  No cached images found.");
-}
-
-spawnSync("docker", ["image", "prune", "--force"], { stdio: "inherit" });
-
-// ─── Done ────────────────────────────────────────────────────────────────────
-outro("Reset complete. Run 'npx totopo' and select 'Start session' to start fresh.");