@evandu/super-pi 0.1.81 → 0.1.83

package/README.md

@@ -1,164 +1,174 @@
-# Super Pi
-
-Super Pi is a cross-platform web control plane and companion for Pi (`@earendil-works/pi`).
-
-It provides a rich Web UI featuring multi-workspace management, interactive agent chats, file browser, subagent delegation, real-time tool inspection, and extensible themes.
-
----
-
-## Installation & Usage
-
-### Method 1: Install as a Pi Plugin (Recommended)
-
-Super Pi is designed to work seamlessly as an official/community extension for Pi:
-
-```bash
-pi install npm:@evandu/super-pi
-```
-
-Once installed, simply launch your Pi terminal as usual, and type:
-
-```text
-/super_pi
-```
-
-This will automatically start the background Super Pi server (port 3080) and open the Web UI in your default browser.
-
-commands available inside pi:
-- `/super_pi` — Open or launch Super Pi
-- `/super_pi stop` — Stop the background Super Pi server
-- `/super_pi restart` — Restart the Super Pi server
-
-To update:
-```bash
-pi update @evandu/super-pi
-# or update all Pi extensions:
-pi update --extensions
-```
-
----
-
-### Method 2: Run directly via npx / Node
-
-You can also run Super Pi standalone without Pi:
-
-```bash
-npx @evandu/super-pi start
-```
-
-Or install globally:
-
-```bash
-npm install -g @evandu/super-pi
-super-pi start   # Start server and open browser
-super-pi stop    # Stop the background server
-super-pi restart # Restart the server
-```
-
-Then visit `http://127.0.0.1:3080` in your browser (or use the printed Network URL `http://<lan-ip>:3080` for LAN access).
-
-Super Pi listens on `0.0.0.0` by default. You can customize the host and port:
-```bash
-super-pi start --host 0.0.0.0 --port 3080
-# Restrict to local loopback only:
-super-pi start --host 127.0.0.1
-```
-
----
-
-## Active memory
-
-Super Pi includes Hermes-style active memory. It saves only durable information, and keeps the three kinds of information separate:
-
-- **User profile**: long-term preferences shared across workspaces.
-- **Workspace facts**: repository conventions and environment facts, visible only in that workspace.
-- **Skills**: validated reusable procedures and pitfalls, stored as Markdown and loaded on demand.
-
-Open **Settings → 主动记忆** to inspect, edit, delete, or approve pending changes; the same panel controls the automatic review interval. Primary Agents can use `memory`, `skill_manage`, and `session_search`. Sub Agents can read relevant material but cannot write it.
-
-### Composer references
-
-Messages may include `@worktree:<name>` to attach the matching Git worktree path from the current workspace, or `@session:<id-or-title>` to attach the recent transcript of another session in the same workspace. These references are expanded into explicit context before the turn is sent to Pi, so an agent repairing a harness can inspect the session where it behaved poorly without switching away from the current session.
-
-After the configured number of completed user turns (10 by default), Super Pi starts a separate, restricted review run. It can only use the three memory tools: it cannot read or modify project files, execute shell commands, or dispatch agents. New facts may be saved automatically; changing or deleting existing facts is staged for approval. A new message or stop cancels that conversation's review.
-
-The feature is on by default. Set `SUPER_PI_MEMORY_ENABLED=0` to disable it, or set `SUPER_PI_MEMORY_REVIEW_INTERVAL=0` to keep manual memory while disabling automatic review. See [the design](docs/ACTIVE_MEMORY_DESIGN.md) for storage limits, lifecycle, and security boundaries.
-
----
-
-## Remote latency diagnosis
-
-For a remote browser, enable phase tracing on the server for one test turn:
-
-```bash
-SUPER_PI_TRACE_LATENCY=1 super-pi start
-```
-
-The server writes `answer.begin`, `pi.spawned`, `prompt.sent`, `pi.first-record`, and `pi.settled` with elapsed milliseconds. This separates process/configuration startup from model time. Streaming is coalesced to one WebSocket update per 16 ms and rendered once per browser frame; structural events such as tool calls and state snapshots flush pending text first.
-
-Use the output to compare a direct SSH Pi run with Super Pi. A long `answer.begin ? pi.spawned` indicates process startup or local configuration work; a long `pi.spawned ? prompt.sent` identifies pre-prompt validation/configuration; a long `prompt.sent ? pi.first-record` belongs to Pi/model/provider. If these phases are fast but the browser remains slow, inspect the network path between the browser and the server.
-
-## Development
-
-```bash
-# Install dependencies
-npm install
-
-# Start development servers (frontend + backend hot-reload)
-npm run dev
-
-# Build for production
-npm run build
-
-# Run check suites
-npm run check
-```
-
----
-
-## License
-
-MIT
-
-
-## Web tools and terminal
-
-### Add a sidebar tool
-
-Open **Tools → 工具设置** and use **复制工具开发 Prompt** in the setup dialog. Ask the Super Pi agent to create the tool; its built-in `tool_register` submits the complete files and mounts the result globally, so the tool is available from every workspace without a separate server.
-
-For a tool that needs local computation, include a Python script in the registration and declare its parameter schema. The script receives one JSON object on stdin and must print one JSON object on stdout. Load the built-in browser SDK from the mounted page:
-
-```html
-<script src="./super-pi-tool.js"></script>
-<script>
-  async function calculate(params) {
-    const run = await SuperPiTool.run(params);
-    return await SuperPiTool.wait(run.id);
-  }
-</script>
-```
-
-`SuperPiTool.run`, `get`, `wait`, and `cancel` are relative, tool-scoped APIs. A page should not call `/api/exec`, guess a tool id, start an HTTP server, or send shell commands. The server enforces the declared schema, timeout, cancellation, and Python process isolation.
-
-Legacy URL bookmarks remain available for opening external HTTP/HTTPS pages, but they are not the mechanism for registering or running a Super Pi tool.
-### Enable the terminal
-
-The terminal is off by default. Set the environment variable before starting Super Pi, then restart it after changing the setting.
-
-PowerShell:
-
-```powershell
-$env:SUPER_PI_TERMINAL="1"
-npm start
-```
-
-macOS/Linux:
-
-```bash
-SUPER_PI_TERMINAL=1 npm start
-```
-
-Select a workspace, then open the **Terminal** tab. The shell starts in that workspace. Windows uses PowerShell by default; set `SUPER_PI_TERMINAL_SHELL` to choose another shell. Terminal connections are limited to localhost and private-network addresses, and the browser cannot choose an arbitrary working directory.
-
-See [docs/TERMINAL.md](docs/TERMINAL.md) for security details and troubleshooting.
+# Super Pi
+
+Super Pi is a cross-platform web control plane and companion for Pi (`@earendil-works/pi`).
+
+It provides a rich Web UI featuring multi-workspace management, interactive agent chats, file browser, subagent delegation, real-time tool inspection, and extensible themes.
+
+---
+
+## Installation & Usage
+
+### Method 1: Install as a Pi Plugin (Recommended)
+
+Super Pi is designed to work seamlessly as an official/community extension for Pi:
+
+```bash
+pi install npm:@evandu/super-pi
+```
+
+Once installed, simply launch your Pi terminal as usual, and type:
+
+```text
+/super_pi
+```
+
+This will automatically start the background Super Pi server (port 3080) and open the Web UI in your default browser.
+
+commands available inside pi:
+- `/super_pi` — Open or launch Super Pi
+- `/super_pi stop` — Stop the background Super Pi server
+- `/super_pi restart` — Restart the Super Pi server
+
+To update:
+```bash
+pi update @evandu/super-pi
+# or update all Pi extensions:
+pi update --extensions
+```
+
+---
+
+### Method 2: Run directly via npx / Node
+
+You can also run Super Pi standalone without Pi:
+
+```bash
+npx @evandu/super-pi start
+```
+
+Or install globally:
+
+```bash
+npm install -g @evandu/super-pi
+super-pi start   # Start server and open browser
+super_pi start   # The underscore spelling is also supported
+super-pi stop    # Stop the background server
+super-pi restart # Restart the server
+```
+
+To start Super Pi automatically when the current user signs in, run:
+
+```bash
+super_pi autostart enable
+super_pi autostart status
+super_pi autostart disable
+```
+
+This registers a per-user startup entry on Windows, macOS, or Linux and does not require administrator access. The automatic process starts the local server without opening a browser. Use `--port` and `--host` with `autostart enable` when the server uses a non-default address.
+
+Then visit `http://127.0.0.1:3080` in your browser (or use the printed Network URL `http://<lan-ip>:3080` for LAN access).
+
+Super Pi listens on `0.0.0.0` by default. You can customize the host and port:
+```bash
+super-pi start --host 0.0.0.0 --port 3080
+# Restrict to local loopback only:
+super-pi start --host 127.0.0.1
+```
+
+---
+
+## Active memory
+
+Super Pi includes Hermes-style active memory. It saves only durable information, and keeps the three kinds of information separate:
+
+- **User profile**: long-term preferences shared across workspaces.
+- **Workspace facts**: repository conventions and environment facts, visible only in that workspace.
+- **Skills**: validated reusable procedures and pitfalls, stored as Markdown and loaded on demand.
+
+Open **Settings → 主动记忆** to inspect, edit, delete, or approve pending changes; the same panel controls the automatic review interval. Primary Agents can use `memory`, `skill_manage`, and `session_search`. Sub Agents can read relevant material but cannot write it.
+
+### Composer references
+
+Messages may include `@worktree:<name>` to attach the matching Git worktree path from the current workspace, or `@session:<id-or-title>` to attach the recent transcript of another session in the same workspace. These references are expanded into explicit context before the turn is sent to Pi, so an agent repairing a harness can inspect the session where it behaved poorly without switching away from the current session.
+
+After the configured number of completed user turns (10 by default), Super Pi starts a separate, restricted review run. It can only use the three memory tools: it cannot read or modify project files, execute shell commands, or dispatch agents. New facts may be saved automatically; changing or deleting existing facts is staged for approval. A new message or stop cancels that conversation's review.
+
+The feature is on by default. Set `SUPER_PI_MEMORY_ENABLED=0` to disable it, or set `SUPER_PI_MEMORY_REVIEW_INTERVAL=0` to keep manual memory while disabling automatic review. See [the design](docs/ACTIVE_MEMORY_DESIGN.md) for storage limits, lifecycle, and security boundaries.
+
+---
+
+## Remote latency diagnosis
+
+For a remote browser, enable phase tracing on the server for one test turn:
+
+```bash
+SUPER_PI_TRACE_LATENCY=1 super-pi start
+```
+
+The server writes `answer.begin`, `pi.spawned`, `prompt.sent`, `pi.first-record`, and `pi.settled` with elapsed milliseconds. This separates process/configuration startup from model time. Streaming is coalesced to one WebSocket update per 16 ms and rendered once per browser frame; structural events such as tool calls and state snapshots flush pending text first.
+
+Use the output to compare a direct SSH Pi run with Super Pi. A long `answer.begin ? pi.spawned` indicates process startup or local configuration work; a long `pi.spawned ? prompt.sent` identifies pre-prompt validation/configuration; a long `prompt.sent ? pi.first-record` belongs to Pi/model/provider. If these phases are fast but the browser remains slow, inspect the network path between the browser and the server.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Start development servers (frontend + backend hot-reload)
+npm run dev
+
+# Build for production
+npm run build
+
+# Run check suites
+npm run check
+```
+
+---
+
+## License
+
+MIT
+
+
+## Web tools and terminal
+
+### Add a sidebar tool
+
+Open **Tools → 工具设置** and use **复制工具开发 Prompt** in the setup dialog. Ask the Super Pi agent to create the tool; its built-in `tool_register` submits the complete files and mounts the result globally, so the tool is available from every workspace without a separate server.
+
+For a tool that needs local computation, include a Python script in the registration and declare its parameter schema. The script receives one JSON object on stdin and must print one JSON object on stdout. Load the built-in browser SDK from the mounted page:
+
+```html
+<script src="./super-pi-tool.js"></script>
+<script>
+  async function calculate(params) {
+    const run = await SuperPiTool.run(params);
+    return await SuperPiTool.wait(run.id);
+  }
+</script>
+```
+
+`SuperPiTool.run`, `get`, `wait`, and `cancel` are relative, tool-scoped APIs. A page should not call `/api/exec`, guess a tool id, start an HTTP server, or send shell commands. The server enforces the declared schema, timeout, cancellation, and Python process isolation.
+
+Legacy URL bookmarks remain available for opening external HTTP/HTTPS pages, but they are not the mechanism for registering or running a Super Pi tool.
+### Enable the terminal
+
+The terminal is built in and starts with Super Pi. It is restricted to local and private-network connections.
+
+PowerShell:
+
+```powershell
+npm start
+```
+
+macOS/Linux:
+
+```bash
+npm start
+```
+
+Select a workspace, then open the **Terminal** tab. The shell starts in that workspace. Windows uses PowerShell by default; set `SUPER_PI_TERMINAL_SHELL` to choose another shell. Terminal connections are limited to localhost and private-network addresses, and the browser cannot choose an arbitrary working directory.
+
+See [docs/TERMINAL.md](docs/TERMINAL.md) for security details and troubleshooting.

package/bin/super-pi.js

@@ -1,128 +1,68 @@
 #!/usr/bin/env node
-import { spawn } from "node:child_process";
-import { resolve } from "node:path";
+import { execFile, spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { promisify } from "node:util";
 
-const entry = resolve(import.meta.dirname, "../dist/server/index.js");
+const execFileAsync = promisify(execFile);
+const root = resolve(import.meta.dirname, "..");
+const entry = resolve(root, "dist/server/index.js");
+const prefix = root.match(/^(.*)[\\/]node_modules[\\/]/i)?.[1];
+const platform = process.env.SUPER_PI_AUTOSTART_PLATFORM ?? process.platform;
+const home = process.env.SUPER_PI_AUTOSTART_HOME ?? homedir();
+const envPort = Number(process.env.SUPER_PI_PORT ?? 3080);
+const defaultPort = Number.isInteger(envPort) && envPort > 0 ? envPort : 3080;
 
-const sub = process.argv[2]?.toLowerCase();
-const port = Number(process.env.SUPER_PI_PORT ?? 3080);
-
-async function isRunning(port) {
-  try {
-    const res = await fetch(`http://127.0.0.1:${port}/api/health`, { signal: AbortSignal.timeout(1000) });
-    if (!res.ok) return false;
-    const data = await res.json();
-    return data?.service === "super-pi";
-  } catch {
-    return false;
+function options(args) {
+  const value = { port: defaultPort, host: process.env.SUPER_PI_HOST ?? "0.0.0.0", browser: true };
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (arg === "--no-browser") value.browser = false;
+    else if (arg === "--browser") value.browser = true;
+    else if (arg === "--port") value.port = Number(args[++i]);
+    else if (arg.startsWith("--port=")) value.port = Number(arg.slice(7));
+    else if (arg === "--host") value.host = args[++i];
+    else if (arg.startsWith("--host=")) value.host = arg.slice(7);
+    else throw new Error(`Unknown option: ${arg}`);
   }
+  if (!value.host || value.host === "undefined") throw new Error("Host must be provided after --host.");
+  if (!Number.isInteger(value.port) || value.port < 1 || value.port > 65535) throw new Error("Port must be an integer from 1 to 65535.");
+  return value;
 }
 
-async function stop(port) {
-  try {
-    const res = await fetch(`http://127.0.0.1:${port}/api/shutdown`, {
-      method: "POST",
-      signal: AbortSignal.timeout(3000),
-    });
-    return res.ok || res.status === 202;
-  } catch {
-    return false;
-  }
-}
-
-function openBrowser(url) {
-  const platform = process.platform;
-  if (platform === "darwin") spawn("open", [url], { detached: true, stdio: "ignore" }).unref();
-  else if (platform === "win32") spawn("cmd.exe", ["/c", "start", "", url], { detached: true, stdio: "ignore" }).unref();
-  else spawn("xdg-open", [url], { detached: true, stdio: "ignore" }).unref();
-}
-
-function usage() {
-  console.error("Usage: super-pi [start|stop|restart|update]");
-  console.error("  start    Open the web console (launch server if not running).");
-  console.error("  stop     Shut the running server down.");
-  console.error("  restart  Stop and start again, picking up the new code on disk.");
-  console.error("  update   Update via npm to the latest @evandu/super-pi, then restart.");
-  process.exit(1);
-}
-
-if (sub === "stop") {
-  const running = await isRunning(port);
-  if (!running) { console.log(`Super Pi is not running on port ${port}`); process.exit(0); }
-  console.log(`Stopping Super Pi on port ${port}...`);
-  const ok = await stop(port);
-  console.log(ok ? "Shutdown requested." : "Shutdown request failed (server may need an access token).");
-  process.exit(0);
-}
-
-if (sub === "update") {
-  // `npm install -g` picks up the latest published version, then we hand off to the same restart
-  // path the in-app button uses. Spawning detached so this terminal can return immediately and
-  // the user's shell isn't tied to the upgrade.
-  console.log("Updating @evandu/super-pi via npm...");
-  const npmCmd = process.platform === "win32" ? "npm.cmd" : "npm";
-  const updater = spawn(npmCmd, ["install", "-g", "@evandu/super-pi"], {
-    stdio: "inherit",
-    shell: process.platform === "win32",
-    env: process.env,
-  });
-  updater.on("error", (error) => {
-    console.error(`npm install failed: ${error instanceof Error ? error.message : "unknown error"}`);
-    process.exit(1);
-  });
-  updater.on("close", (code) => {
-    if (code !== 0) { console.error(`npm install exited with code ${code}`); process.exit(code ?? 1); }
-    console.log("Update installed. Restarting Super Pi...");
-    // The server itself uses scripts/restart-server.mjs for the same job; reuse it.
-    const restart = spawn(process.execPath, [resolve(import.meta.dirname, "../scripts/restart-server.mjs")], {
-      detached: true,
-      stdio: "ignore",
-      env: process.env,
-    });
-    restart.unref();
-    process.exit(0);
-  });
-  // The handler above is the only path out; the process keeps running so npm's output reaches
-  // this terminal.
-  // Keep the process alive until the updater's close handler exits it.
-  await new Promise(() => {});
+async function running(port) {
+  try { const response = await fetch(`http://127.0.0.1:${port}/api/health`, { signal: AbortSignal.timeout(1000) }); return response.ok && (await response.json()).service === "super-pi"; } catch { return false; }
 }
-
-if (sub === "restart") {
-  if (await isRunning(port)) {
-    console.log(`Restarting Super Pi on port ${port}...`);
-    await stop(port);
-    await new Promise((r) => setTimeout(r, 600));
-  } else {
-    console.log(`Super Pi is not running on port ${port}; starting fresh.`);
-  }
-} else if (sub && sub !== "start") {
-  usage();
-}
-
-const running = await isRunning(port);
-if (!running) {
-  console.log("Starting Super Pi...");
-  const child = spawn(process.execPath, [entry, `--port=${port}`], {
-    detached: true,
-    stdio: "ignore",
-    env: process.env,
-  });
-  child.unref();
-
-  const deadline = Date.now() + 8000;
-  while (Date.now() < deadline) {
-    await new Promise((r) => setTimeout(r, 200));
-    if (await isRunning(port)) break;
-  }
-
-  if (!(await isRunning(port))) {
-    console.error("Server did not respond within 8 seconds.");
-    process.exit(1);
-  }
-  console.log(`Super Pi is running at http://127.0.0.1:${port}`);
+async function stop(port) { try { const headers = process.env.SUPER_PI_ACCESS_TOKEN ? { authorization: `Bearer ${process.env.SUPER_PI_ACCESS_TOKEN}` } : {}; const response = await fetch(`http://127.0.0.1:${port}/api/shutdown`, { method: "POST", headers, signal: AbortSignal.timeout(3000) }); return response.ok || response.status === 202; } catch { return false; } }
+function openBrowser(url) { const command = platform === "darwin" ? "open" : platform === "win32" ? "cmd.exe" : "xdg-open"; const args = platform === "darwin" ? [url] : platform === "win32" ? ["/c", "start", "", url] : [url]; spawn(command, args, { detached: true, stdio: "ignore", windowsHide: true }).unref(); }
+function usage() { console.log("Usage: super-pi|super_pi <start|stop|restart|update|autostart> [options]"); console.log("  autostart enable|disable|status  Configure startup at sign-in"); console.log("  --port PORT  Server port (default: 3080)"); console.log("  --host HOST  Server host (default: 0.0.0.0)"); console.log("  --no-browser  Do not open a browser"); }
+function paths() { if (platform === "win32") return { task: "Super Pi" }; if (platform === "darwin") return { file: join(home, "Library", "LaunchAgents", "com.evandu.super-pi.plist") }; return { file: join(process.env.XDG_CONFIG_HOME ?? join(home, ".config"), "systemd", "user", "super-pi.service") }; }
+async function system(command, args) { if (process.env.SUPER_PI_AUTOSTART_DRY_RUN === "1") { console.log(`[dry-run] ${command} ${args.join(" ")}`); return; } await execFileAsync(command, args, { windowsHide: true }); }
+async function enable(value) {
+  const target = paths();
+  if (platform === "win32") { const command = `"${process.execPath}" "${entry}" --host "${value.host}" --port ${value.port} --no-browser`; await system("schtasks.exe", ["/Create", "/TN", target.task, "/SC", "ONLOGON", "/TR", command, "/RL", "LIMITED", "/F"]); }
+  else if (platform === "darwin") { const content = `<?xml version="1.0" encoding="UTF-8"?><plist version="1.0"><dict><key>Label</key><string>com.evandu.super-pi</string><key>ProgramArguments</key><array><string>${process.execPath}</string><string>${entry}</string><string>--host</string><string>${value.host}</string><string>--port</string><string>${value.port}</string></array><key>RunAtLoad</key><true/><key>KeepAlive</key><true/></dict></plist>`; if (process.env.SUPER_PI_AUTOSTART_DRY_RUN !== "1") { await mkdir(dirname(target.file), { recursive: true }); await writeFile(target.file, content); } else console.log(`[dry-run] write ${target.file}\n${content}`); await system("launchctl", ["bootout", `gui/${process.getuid?.() ?? "501"}`, target.file]).catch(() => {}); await system("launchctl", ["bootstrap", `gui/${process.getuid?.() ?? "501"}`, target.file]); }
+  else { const content = `[Unit]\nDescription=Super Pi\nAfter=default.target\n\n[Service]\nExecStart=${process.execPath} ${entry} --host ${value.host} --port ${value.port}\nRestart=on-failure\n\n[Install]\nWantedBy=default.target\n`; if (process.env.SUPER_PI_AUTOSTART_DRY_RUN !== "1") { await mkdir(dirname(target.file), { recursive: true }); await writeFile(target.file, content); } else console.log(`[dry-run] write ${target.file}\n${content}`); await system("systemctl", ["--user", "daemon-reload"]); await system("systemctl", ["--user", "enable", "--now", "super-pi.service"]); }
+  console.log("Automatic startup enabled.");
 }
+async function disable() { const target = paths(); if (platform === "win32") await system("schtasks.exe", ["/Delete", "/TN", target.task, "/F"]).catch(() => {}); else if (platform === "darwin") { await system("launchctl", ["bootout", `gui/${process.getuid?.() ?? "501"}`, target.file]).catch(() => {}); if (process.env.SUPER_PI_AUTOSTART_DRY_RUN !== "1") await rm(target.file, { force: true }); } else { await system("systemctl", ["--user", "disable", "--now", "super-pi.service"]).catch(() => {}); if (process.env.SUPER_PI_AUTOSTART_DRY_RUN !== "1") await rm(target.file, { force: true }); } console.log("Automatic startup disabled."); }
+async function status() { const target = paths(); let enabled = false; if (platform === "win32") { try { await execFileAsync("schtasks.exe", ["/Query", "/TN", target.task]); enabled = true; } catch {} } else enabled = existsSync(target.file); console.log(enabled ? "Automatic startup is enabled." : "Automatic startup is disabled."); }
+async function start(value) { if (await running(value.port)) return; const child = spawn(process.execPath, [entry, `--port=${value.port}`, `--host=${value.host}`], { detached: true, stdio: "ignore", env: process.env, windowsHide: true }); child.unref(); const until = Date.now() + 8000; while (Date.now() < until && !(await running(value.port))) await new Promise((resolve) => setTimeout(resolve, 200)); if (!(await running(value.port))) throw new Error("Server did not respond within 8 seconds."); }
 
-const url = `http://127.0.0.1:${port}`;
-openBrowser(url);
-console.log(`Opened ${url}`);
+const [raw, ...rest] = process.argv.slice(2);
+const implicitStart = raw?.startsWith("-") ?? false;
+const command = implicitStart ? "start" : raw?.toLowerCase();
+const args = implicitStart ? [raw, ...rest] : rest;
+try {
+  if (command === "help" || command === "--help" || command === "-h") { usage(); process.exit(0); }
+  if (!command) { const value = options(args); await start(value); const url = `http://127.0.0.1:${value.port}`; if (value.browser) openBrowser(url); console.log(value.browser ? `Opened ${url}` : `Super Pi is running at ${url}`); process.exit(0); }
+  if (command === "autostart" || command === "startup") { const action = args.shift()?.toLowerCase() ?? "status"; const value = options(args); if (action === "enable") await enable(value); else if (action === "disable") await disable(); else if (action === "status") await status(); else throw new Error("Autostart action must be enable, disable, or status."); process.exit(0); }
+  if (!["start", "stop", "restart", "update"].includes(command)) throw new Error(`Unknown command: ${command}`);
+  if (command === "update") { const npm = platform === "win32" ? "npm.cmd" : "npm"; const args = prefix ? ["install", "--prefix", prefix, "@evandu/super-pi"] : ["install", "-g", "@evandu/super-pi"]; const child = spawn(npm, args, { stdio: "inherit", shell: platform === "win32", env: process.env }); const code = await new Promise((resolve) => child.on("close", resolve)); if (code !== 0) process.exit(code ?? 1); }
+  const value = options(args);
+  if (command === "stop") { console.log(await running(value.port) ? (await stop(value.port) ? `Shutdown requested on port ${value.port}.` : "Shutdown request failed.") : `Super Pi is not running on port ${value.port}.`); process.exit(0); }
+  if ((command === "restart" || command === "update") && await running(value.port)) { await stop(value.port); await new Promise((resolve) => setTimeout(resolve, 600)); }
+  await start(value); const url = `http://127.0.0.1:${value.port}`; if (value.browser) openBrowser(url); console.log(value.browser ? `Opened ${url}` : `Super Pi is running at ${url}`);
+} catch (error) { console.error(error instanceof Error ? error.message : String(error)); usage(); process.exit(1); }

package/dist/client/.super-pi-client-sources.json

@@ -1,7 +1,7 @@
 {
-  "hash": "4418fb7ff22019f9783d5a370c83ed304599092dfd18100f5e70435ac9b132c2",
+  "hash": "59d7e55dddc214a9c6ca40ce240cf5d420c82882d29d3d5dbbf344884ed9e30e",
   "files": {
-    "src/client/App.tsx": "5c22b94c82d9f3ccaf9e9a210a97a3b2b84c72b76cfdb6aa54b36fb74438446d",
+    "src/client/App.tsx": "65bec0788a20d51690adaa247bbf56e22183093eeee8d07555fec7eb4c94ec0a",
     "src/client/FilesPanel.tsx": "17c3e7ef10914a8836c209bc47a51ad06d73025feb755ee8f68bba8f79ce6d16",
     "src/client/GitPanel.tsx": "c44f3c73936af73f436ec6a8cd9ee50f5367dd6887f881fa133ec101fb99bbac",
     "src/client/HelpWindow.tsx": "807a3e7119e958701bcfcef2a3cb66d6ec05bca1df96e4639c5ae77d8cb79975",
@@ -9,17 +9,17 @@
     "src/client/MemoryPanel.tsx": "f0475b526e3380407a82ccaa3f9229fe62c091122f1e452797f3ce3316074cee",
     "src/client/SlashCommandMenu.tsx": "47d4051df75507c15c894cff590f538a0223f3a365aa5f1b90925d86670972d6",
     "src/client/Tabs.tsx": "6e48f318b1fe4678f438c6e2a41eeb49e89ee9c67b981f7d6154cd7060a048ab",
-    "src/client/TerminalPanel.tsx": "fca10b6637f165619091fd5d7183c238d36cf5fd6be52aedf3c4fdcafe2b1fff",
+    "src/client/TerminalPanel.tsx": "0437ac55a24823bf24548569f383dd29480ab2340ed789c0e7e8336e5af54e28",
     "src/client/WorkflowCard.tsx": "c363f9b3b612745f91fb46ec16d188fde0f36af7e406499d27eb552793e9fe22",
     "src/client/main.tsx": "d6325cec79ebc225e4972c33ad9b4266fa1eab5f962fec36ed4c539124a8fcab",
     "src/client/markdown.ts": "4848429b351ec1030dd8e108f3d6ff3f93f2b558c2c27a310a5290af130186a6",
     "src/client/slash-commands.ts": "a202263497e3ca023e40f3462e04f858cfbddb5ed19a40d188bd5363f3762621",
-    "src/client/styles.css": "7f6454a2a29aee5084a6e36d7679d5c648392bb084a70e32bb9cb994d1ace142",
+    "src/client/styles.css": "04962f62cea0978471e597d0cf5a2bd1b364e2e598dcb37afa8fe2e14dce6328",
     "src/client/terminal-emulator.ts": "ffcc4f5fbddaf25cebcc9e03dbe5d7d0ad2c21586f5d169e57c04c82e2308b3b",
     "src/client/theme.tsx": "d01885d69a3b363a8bcbbd0c6bfbc4ae8004fa18c1f93f4834c47b4ef743a60c",
     "src/client/tools.ts": "58fe41f0edbd490e3fab7f12f258b1dbc2163b653553b03ac61caf1543618e50",
     "src/client/types.ts": "11fd40e5784a2e765635f4f57d6edd5c97ad0eae85b1825b9da32a88d25b4db9",
     "src/client/vite-env.d.ts": "65996936fbb042915f7b74a200fcdde7e410f32a669b1ab9597cfaa4b0faddb5"
   },
-  "recordedAt": "2026-10-18T00:09:25.847Z"
+  "recordedAt": "2026-10-18T02:43:39.581Z"
 }