@aspct3434/distill-agent 0.2.0 → 0.2.1

package/README.md

@@ -111,7 +111,7 @@ docker compose up -d --build
 
 ### CLI Installation
 
-You can also install Distill globally using `npm` to get the robust interactive CLI installer:
+You can also install Distill globally using `npm` to get the robust interactive CLI installer and TUI:
 
 ```powershell
 npx @aspct3434/distill-agent install
@@ -119,6 +119,13 @@ npx @aspct3434/distill-agent install
 
 After installation, use the CLI to manage the agent:
 ```bash
+npm install -g @aspct3434/distill-agent
+distill                           # Open the interactive terminal UI
+distill start                     # Start the backend and control panel
+distill logs                      # View running logs
+distill update                    # Pull the latest changes
+
+# npx works too if you prefer not to install globally:
 npx @aspct3434/distill-agent start    # Start the backend and control panel
 npx @aspct3434/distill-agent logs     # View running logs
 npx @aspct3434/distill-agent update   # Pull the latest changes

package/lib/distill-cli.js

@@ -192,6 +192,7 @@ function banner() {
     lines.push(c.bold(hex(colors[i], line)));
   });
   lines.push("");
+  lines.push(`      ${c.bold(hex("#A855F7", "DISTILL"))}`);
   lines.push(`      ${hex("#6B7280", "v" + packageVersion())}  ${c.dim("·")}  ${hex("#A855F7", "Autonomous Agent Framework")}`);
   lines.push(`      ${hex("#6B7280", "Evidence-gated execution · Skill distillation · Hybrid memory")}`);
   lines.push("");
@@ -223,6 +224,7 @@ function usage() {
 ${c.bold("Distill")} — installer and lifecycle CLI
 
 ${hex("#A855F7", "Usage:")}
+  distill                         Launch the interactive Terminal UI
   distill install [options]       Interactive guided setup
   distill doctor  [options]       Health check
   distill start   [options]       Start backend + control panel
@@ -230,6 +232,7 @@ ${hex("#A855F7", "Usage:")}
   distill restart [options]       Restart all services
   distill update  [options]       Pull latest + restart
   distill logs    [options]       View service logs
+  distill tui     [options]       Launch the Terminal UI
 
 ${hex("#A855F7", "Install options:")}
   --repo-url URL         Git repository URL
@@ -248,8 +251,11 @@ ${hex("#A855F7", "Lifecycle options:")}
   --sandbox on|off       Override sandbox mode
   --tail NUMBER          Number of log lines to show ${c.dim("(default: 200)")}
   --follow               Stream logs continuously
+  --url URL              Gateway WebSocket URL for the TUI
+  --theme NAME           TUI theme ${c.dim("(distill|ocean|ember|mono)")}
 
 ${hex("#A855F7", "Examples:")}
+  ${c.dim("$")} distill
   ${c.dim("$")} npx @aspct3434/distill-agent install
   ${c.dim("$")} npx @aspct3434/distill-agent doctor
   ${c.dim("$")} npx @aspct3434/distill-agent logs --tail 100 --follow
@@ -257,7 +263,7 @@ ${hex("#A855F7", "Examples:")}
 }
 
 function parseArgs(argv) {
-  const result = { command: "help", options: {} };
+  const result = { command: "tui", options: {} };
   const args = [...argv];
   if (args.length > 0 && !args[0].startsWith("-")) {
     result.command = args.shift();
@@ -270,7 +276,9 @@ function parseArgs(argv) {
     "sandbox",
     "messaging",
     "mode",
-    "tail"
+    "tail",
+    "url",
+    "theme"
   ]);
   const booleanOptions = new Set([
     "dry-run",
@@ -1241,9 +1249,10 @@ async function startServices(config) {
     `${hex("#A855F7", "Control Panel:")}  ${c.underline("http://localhost:5173")}`,
     `${hex("#A855F7", "API Docs:")}       ${c.underline("http://localhost:8000/docs")}`,
     `${hex("#A855F7", "Health Check:")}   ${c.underline("http://localhost:8000/health")}`,
-    `${hex("#A855F7", "Terminal UI:")}    ${c.dim("python src/tui.py")}`,
+    `${hex("#A855F7", "Terminal UI:")}    ${c.dim("distill")}`,
     "",
     `${c.dim("Manage with:")}`,
+    `  ${c.dim("$")} distill`,
     `  ${c.dim("$")} npx @aspct3434/distill-agent stop`,
     `  ${c.dim("$")} npx @aspct3434/distill-agent logs --follow`,
     `  ${c.dim("$")} npx @aspct3434/distill-agent doctor`,
@@ -1347,6 +1356,19 @@ function spawnDetached(command, args, cwd, stdoutPath, stderrPath, dryRun) {
     logStep(`[dry-run] ${formatCommand(command, args)} > ${stdoutPath} 2> ${stderrPath}`, cwd);
     return { pid: 0 };
   }
+  if (process.platform === "win32") {
+    const psArgs = [
+      "-NoProfile", "-NonInteractive", "-Command",
+      `$proc = Start-Process -FilePath "${command}" -ArgumentList @(${args.map(a => `"${a.replace(/"/g, '""')}"`).join(", ")}) -WorkingDirectory "${cwd}" -WindowStyle Hidden -PassThru -RedirectStandardOutput "${stdoutPath}" -RedirectStandardError "${stderrPath}"; Write-Output $proc.Id`
+    ];
+    const result = spawnSync("powershell", psArgs, { windowsHide: true });
+    const pidStr = result.stdout ? result.stdout.toString().trim() : "";
+    const pid = parseInt(pidStr, 10);
+    if (isNaN(pid)) {
+      throw new Error(`Failed to start detached process on Windows. Output: ${result.stdout} ${result.stderr}`);
+    }
+    return { pid };
+  }
   const stdout = fs.openSync(stdoutPath, "a");
   const stderr = fs.openSync(stderrPath, "a");
   const child = spawn(command, args, {
@@ -1491,6 +1513,35 @@ async function doctor(options) {
   }
 }
 
+// ─── TUI ─────────────────────────────────────────────────────────────────────
+
+function resolveTuiPython(config) {
+  for (const name of [".run-venv", "venv"]) {
+    const venvDir = path.join(config.installDir, name);
+    const candidate = virtualEnvPython(venvDir);
+    if (fs.existsSync(candidate)) return [candidate, []];
+  }
+  const systemPython = pythonCommand();
+  if (systemPython && isAgentRepo(config.installDir)) return systemPython;
+  throw new Error(
+    "Python environment not found. Run 'distill install' first, or run from a Distill checkout with dependencies installed."
+  );
+}
+
+async function startTui(config, options = {}) {
+  if (!config.dryRun && !isAgentRepo(config.installDir)) {
+    throw new Error(`Install directory is not a Distill checkout: ${config.installDir}`);
+  }
+  const [python, pythonPrefix] = config.dryRun
+    ? (pythonCommand() || ["python3", []])
+    : resolveTuiPython(config);
+  const args = [...pythonPrefix, "src/tui.py"];
+  if (options.url) args.push("--url", options.url);
+  if (options.theme) args.push("--theme", options.theme);
+
+  await run(python, args, { cwd: config.installDir, stdio: "inherit", dryRun: config.dryRun });
+}
+
 // ─── Install ─────────────────────────────────────────────────────────────────
 
 async function install(options) {
@@ -1558,6 +1609,7 @@ async function install(options) {
 
 async function main(argv = process.argv.slice(2)) {
   const { command, options } = parseArgs(argv);
+  const implicitTui = argv.length === 0;
   switch (command) {
     case "help":
     case undefined:
@@ -1597,6 +1649,14 @@ async function main(argv = process.argv.slice(2)) {
     case "logs":
       await showLogs(resolveRuntimeConfig(options), options);
       break;
+    case "tui":
+      if (implicitTui && (!process.stdin.isTTY || !process.stdout.isTTY)) {
+        console.log(banner());
+        console.log(usage());
+        break;
+      }
+      await startTui(resolveRuntimeConfig(options), options);
+      break;
     default:
       throw new Error(`Unknown command: ${command}\n${usage()}`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aspct3434/distill-agent",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Distill — interactive installer and lifecycle CLI for the Distill autonomous agent framework.",
   "bin": {
     "distill": "bin/distill.js"