fellow-agents 0.0.11 → 0.0.14

package/dist/cli.js

@@ -2,8 +2,10 @@
 const args = process.argv.slice(2);
 // Default to "start" if no command given or first arg is a flag
 const command = args[0] === "stop" ? "stop"
-    : (args[0] === "--help" || args[0] === "-h") ? "help"
-        : "start";
+    : args[0] === "clean" ? "clean"
+        : args[0] === "uninstall" ? "uninstall"
+            : (args[0] === "--help" || args[0] === "-h") ? "help"
+                : "start";
 function getFlag(name, fallback) {
     const idx = args.indexOf(name);
     return idx !== -1 && args[idx + 1] ? args[idx + 1] : fallback;
@@ -25,12 +27,25 @@ else if (command === "stop") {
     const { stop } = await import("./commands/stop.js");
     stop();
 }
+else if (command === "clean") {
+    const { clean } = await import("./commands/clean.js");
+    clean();
+}
+else if (command === "uninstall") {
+    const { uninstall } = await import("./commands/uninstall.js");
+    uninstall({
+        dir: getFlag("--dir", process.cwd()),
+        yes: hasFlag("--yes"),
+    });
+}
 else {
     console.log(`fellow-agents — multi-agent system for Claude Code
 
 Usage:
   fellow-agents [options]            Start services (default)
   fellow-agents stop                 Stop all running services
+  fellow-agents clean                Wipe cached binaries + pty-win, preserve logs
+  fellow-agents uninstall [--yes]    Remove all fellow-agents state (data dir + workspaces)
 
 Options:
   --port <number>       pty-win port (default: 3700)
@@ -38,6 +53,7 @@ Options:
   --dir <path>          Working directory (default: current)
   --no-browser          Don't open browser
   --update              Force re-download binaries
+  --yes                 Skip confirmation prompt (uninstall only)
 
   -h, --help            Show this help`);
 }

package/dist/commands/clean.js

@@ -0,0 +1,72 @@
+import { existsSync, rmSync, statSync, readdirSync } from "fs";
+import { join } from "path";
+import { dataDir, binDir, ptyWinDir, pidDir } from "../lib/paths.js";
+import { stopAll } from "../lib/services.js";
+function dirSize(path) {
+    if (!existsSync(path))
+        return 0;
+    let total = 0;
+    const stack = [path];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        try {
+            const stat = statSync(current);
+            if (stat.isDirectory()) {
+                for (const entry of readdirSync(current))
+                    stack.push(join(current, entry));
+            }
+            else {
+                total += stat.size;
+            }
+        }
+        catch { }
+    }
+    return total;
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+    return `${(bytes / 1024 / 1024 / 1024).toFixed(2)} GB`;
+}
+export function clean() {
+    console.log("");
+    console.log("  Cleaning fellow-agents state...");
+    stopAll();
+    // Wipe these — logs/ is preserved for postmortem
+    const targets = [
+        { label: "bin", path: binDir },
+        { label: "pty-win", path: ptyWinDir },
+        { label: "pid", path: pidDir },
+    ];
+    let totalFreed = 0;
+    for (const t of targets) {
+        if (existsSync(t.path)) {
+            const size = dirSize(t.path);
+            try {
+                rmSync(t.path, { recursive: true, force: true });
+                console.log(`  Removed ${t.label}/ (${formatBytes(size)})`);
+                totalFreed += size;
+            }
+            catch (err) {
+                console.error(`  Failed to remove ${t.label}/: ${err.message}`);
+            }
+        }
+    }
+    // Reset version stamp (separate from bin/ since it's nested but worth calling out)
+    const versionPath = join(dataDir, "bin", ".version");
+    if (existsSync(versionPath)) {
+        try {
+            rmSync(versionPath);
+        }
+        catch { }
+    }
+    console.log("");
+    console.log(`  Cleaned ${formatBytes(totalFreed)} from ${dataDir}`);
+    console.log(`  Logs preserved at ${join(dataDir, "logs")}`);
+    console.log(`  Run 'fellow-agents' to reinstall.`);
+    console.log("");
+}

package/dist/commands/uninstall.js

@@ -0,0 +1,99 @@
+import { existsSync, rmSync, statSync, readdirSync } from "fs";
+import { join, resolve } from "path";
+import { dataDir } from "../lib/paths.js";
+import { stopAll } from "../lib/services.js";
+function dirSize(path) {
+    if (!existsSync(path))
+        return 0;
+    let total = 0;
+    const stack = [path];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        try {
+            const stat = statSync(current);
+            if (stat.isDirectory()) {
+                for (const entry of readdirSync(current))
+                    stack.push(join(current, entry));
+            }
+            else {
+                total += stat.size;
+            }
+        }
+        catch { }
+    }
+    return total;
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+    return `${(bytes / 1024 / 1024 / 1024).toFixed(2)} GB`;
+}
+export function uninstall(opts) {
+    const workDir = resolve(opts.dir);
+    // Two possible workspace locations — start.ts uses either depending on whether cwd has workspaces/
+    const wsCandidates = [
+        join(workDir, "workspaces"),
+        join(workDir, "fellow-agents", "workspaces"),
+    ];
+    const targets = [];
+    if (existsSync(dataDir)) {
+        targets.push({ label: "Data directory", path: dataDir, size: dirSize(dataDir) });
+    }
+    for (const ws of wsCandidates) {
+        if (existsSync(ws)) {
+            targets.push({ label: "Workspaces", path: ws, size: dirSize(ws) });
+        }
+    }
+    console.log("");
+    console.log("  fellow-agents uninstall");
+    console.log("  =======================");
+    console.log("");
+    if (targets.length === 0) {
+        console.log("  Nothing to remove — no fellow-agents state found.");
+        console.log("");
+        console.log("  To uninstall the npm package itself, run:");
+        console.log("    npm uninstall -g fellow-agents");
+        console.log("");
+        return;
+    }
+    const totalSize = targets.reduce((sum, t) => sum + t.size, 0);
+    console.log("  The following will be permanently removed:");
+    console.log("");
+    for (const t of targets) {
+        console.log(`    ${t.path}  (${formatBytes(t.size)})`);
+    }
+    console.log("");
+    console.log(`  Total: ${formatBytes(totalSize)}`);
+    console.log("");
+    if (!opts.yes) {
+        console.log("  This is a dry run. To proceed, add --yes:");
+        console.log("    fellow-agents uninstall --yes");
+        console.log("");
+        console.log("  Tip: pass --dir <path> if your workspaces are elsewhere.");
+        console.log("");
+        return;
+    }
+    // Actually do the uninstall
+    console.log("  Stopping services...");
+    stopAll();
+    console.log("");
+    for (const t of targets) {
+        try {
+            rmSync(t.path, { recursive: true, force: true });
+            console.log(`  Removed ${t.path}`);
+        }
+        catch (err) {
+            console.error(`  Failed to remove ${t.path}: ${err.message}`);
+        }
+    }
+    console.log("");
+    console.log("  fellow-agents state removed.");
+    console.log("");
+    console.log("  To uninstall the npm package itself, run:");
+    console.log("    npm uninstall -g fellow-agents");
+    console.log("");
+}

package/dist/lib/services.js

@@ -1,4 +1,4 @@
-import { spawn } from "child_process";
+import { spawn, execSync } from "child_process";
 import http from "http";
 import https from "https";
 import { mkdirSync, writeFileSync, readFileSync, existsSync, rmSync, openSync } from "fs";
@@ -78,12 +78,23 @@ export function startPtyWin(port, workspacesDir, emcomUrl, env) {
     writePid("pty-win", proc.pid);
     return proc.pid;
 }
+// On Windows, PyInstaller --onefile binaries (like emcom-server) run as a bootloader + child
+// process. process.kill() only kills the bootloader; the child keeps the socket. taskkill /T
+// walks the process tree so the child dies too.
+function killTree(pid) {
+    if (process.platform === "win32") {
+        execSync(`taskkill /F /T /PID ${pid}`, { stdio: "ignore" });
+    }
+    else {
+        process.kill(pid);
+    }
+}
 export function stopAll() {
     for (const name of ["emcom-server", "pty-win"]) {
         const pid = readPid(name);
         if (pid && isRunning(pid)) {
             try {
-                process.kill(pid);
+                killTree(pid);
                 console.log(`  Stopped ${name} (pid ${pid})`);
             }
             catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fellow-agents",
-  "version": "0.0.11",
+  "version": "0.0.14",
   "description": "Multi-agent system — multiple Claude Code instances collaborating via messaging",
   "type": "module",
   "bin": {