trismegistus 1.0.3 → 1.1.0

package/README.md

@@ -4,33 +4,30 @@ A local persistent daemon that runs Claude Code sessions from a task queue. Add
 
 ## Install
 
-```bash
-npm install -D trismegistus
-```
-
-Or install globally:
-
 ```bash
 npm install -g trismegistus
 ```
 
+This gives you the `tmg` command globally — use it from any project.
+
 ### Prerequisites
 
 - Node.js >= 18
 - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and authenticated (`npm install -g @anthropic-ai/claude-code`)
+- Enable remote control in your Claude Code settings to monitor sessions from claude.ai/code or the Claude mobile app (`remote_control: true` for all sessions)
 
 ## Quick Start
 
 ```bash
 # Initialize in your project
-npx tmg init
+tmg init
 
 # Add tasks from the CLI
-npx tmg add "Migrate user model to TypeScript"
-npx tmg add "Write tests for the payment module"
+tmg add "Migrate user model to TypeScript"
+tmg add "Write tests for the payment module"
 
 # Start the daemon
-npx tmg start
+tmg start
 ```
 
 The daemon picks up tasks one at a time, runs each in a full Claude Code session with `--dangerously-skip-permissions`, commits the work, and moves on to the next.
@@ -108,13 +105,15 @@ echo "- [ ] Fix the bug in the login form" >> .trismegistus/tasks.md
 
 ### Monitor from your phone
 
-`tmg remote` creates a secure VS Code tunnel through Microsoft's Azure relay and prints a QR code. Scan it on your phone to get a full VS Code UI — including terminal access — right in the browser. No port forwarding or same-network requirement.
+`tmg remote` creates a secure tunnel through Microsoft's Azure relay and prints a QR code. Scan it on your phone to get a full editor UI — including terminal access — right in the browser. No port forwarding or same-network requirement.
+
+Works with both VS Code and Cursor — it auto-detects which editor you're using and runs the correct tunnel command.
 
 ```bash
 tmg remote
 ```
 
-Prerequisites: VS Code `code` CLI installed, GitHub account (one-time device auth on first use).
+Prerequisites: VS Code (`code`) or Cursor (`cursor`) CLI installed, GitHub account (one-time device auth on first use).
 
 You can set a custom tunnel name:
 

package/dist/cli.js

@@ -80,9 +80,20 @@ var CLAUDE_COMMANDS = [
     name: "tmg.md",
     content: `Start the Trismegistus daemon to continuously run tasks from the queue.
 
-Run: \`tmg start\`
+**Important:** \`tmg start\` is a long-running daemon that needs its own terminal. Do NOT run it inline here.
 
-The daemon picks up pending tasks from \`.trismegistus/tasks.md\` and executes them one by one, idling and watching for new tasks when the queue is empty.
+Run this command in a **separate terminal**:
+
+\`\`\`
+tmg start
+\`\`\`
+
+The daemon:
+- Picks up pending tasks from \`.trismegistus/tasks.md\`
+- Opens a VS Code tunnel for remote editor access (QR code)
+- Idles and watches for new tasks when the queue is empty
+
+**Note:** To monitor sessions remotely, enable remote control in your Claude Code settings (\`remote_control: true\` for all sessions).
 
 $ARGUMENTS
 `
@@ -377,38 +388,39 @@ function loadConfig(projectDir) {
 
 // src/runner.ts
 import { spawn } from "child_process";
-function runClaude(prompt, timeoutMs, projectDir, spawnFn = spawn) {
+function defaultSpawn(command, args, cwd) {
+  return spawn(command, args, { cwd, stdio: "ignore" });
+}
+function runClaude(opts) {
+  const { prompt, timeoutMs, projectDir, spawnFn = defaultSpawn } = opts;
   return new Promise((resolve) => {
-    const ac = new AbortController();
     let timedOut = false;
+    let settled = false;
+    const child = spawnFn(
+      "claude",
+      ["-p", prompt, "--dangerously-skip-permissions"],
+      projectDir
+    );
     const timer = setTimeout(() => {
       timedOut = true;
-      ac.abort();
+      child.kill();
     }, timeoutMs);
-    const child = spawnFn(
-      "claude",
-      ["--dangerously-skip-permissions", "-p", prompt],
-      {
-        cwd: projectDir,
-        stdio: "inherit",
-        signal: ac.signal
+    function settle(result) {
+      if (!settled) {
+        settled = true;
+        clearTimeout(timer);
+        resolve(result);
       }
-    );
-    child.on("close", (code) => {
-      clearTimeout(timer);
-      resolve({
+    }
+    child.on("exit", (code) => {
+      settle({
         success: !timedOut && code === 0,
         exitCode: timedOut ? 124 : code ?? 1,
         timedOut
       });
     });
-    child.on("error", (err) => {
-      clearTimeout(timer);
-      resolve({
-        success: false,
-        exitCode: 1,
-        timedOut: timedOut || err.name === "AbortError"
-      });
+    child.on("error", () => {
+      settle({ success: false, exitCode: 1, timedOut: false });
     });
   });
 }
@@ -503,12 +515,12 @@ async function runDaemon(opts) {
       notes,
       handoff
     );
-    const result = await runClaude(
+    const result = await runClaude({
       prompt,
-      config.timeoutMinutes * 60 * 1e3,
+      timeoutMs: config.timeoutMinutes * 60 * 1e3,
       projectDir,
       spawnFn
-    );
+    });
     if (result.success) {
       setTaskStatus(projectDir, task.text, "x");
       deleteHandoff(projectDir);
@@ -559,25 +571,29 @@ function cliExists(cli) {
     return false;
   }
 }
-function checkCodeCli() {
-  const detected = detectEditorCli();
-  if (cliExists(detected)) return detected;
-  const fallback = detected === "cursor" ? "code" : "cursor";
-  if (cliExists(fallback)) return fallback;
-  throw new Error(
-    `Neither "cursor" nor "code" CLI found. Install VS Code or Cursor, or download the standalone CLI: https://code.visualstudio.com/docs/editor/command-line`
-  );
+function isVSCodeAvailable() {
+  return cliExists("code");
+}
+function isCursorDetected() {
+  return detectEditorCli() === "cursor";
 }
-function startTunnel(name, cli = "code") {
+function startTunnel(name, options = {}) {
+  if (!isVSCodeAvailable()) {
+    return Promise.reject(
+      new Error(
+        '"code" CLI not found. Install VS Code or download the standalone CLI: https://code.visualstudio.com/docs/editor/command-line'
+      )
+    );
+  }
   return new Promise((resolve, reject) => {
     const child = spawn2(
-      cli,
+      "code",
       ["tunnel", "--name", name, "--accept-server-license-terms"],
       { stdio: ["ignore", "pipe", "pipe"] }
     );
     let stderr = "";
     let settled = false;
-    const TIMEOUT_MS = 6e4;
+    const TIMEOUT_MS = 12e4;
     function settle(fn) {
       if (!settled) {
         settled = true;
@@ -587,15 +603,26 @@ function startTunnel(name, cli = "code") {
     const timer = setTimeout(() => {
       child.kill();
       const msg = stderr ? `Timed out waiting for tunnel URL. stderr:
-${stderr}` : "Timed out waiting for tunnel URL. You may need to authenticate \u2014 run `code tunnel` manually first.";
+${stderr}` : `Timed out waiting for tunnel URL. You may need to authenticate \u2014 run \`code tunnel\` manually first.`;
       settle(() => reject(new Error(msg)));
     }, TIMEOUT_MS);
     child.stderr?.on("data", (chunk) => {
-      stderr += chunk.toString();
+      const text = chunk.toString();
+      stderr += text;
+      if (options.onOutput) {
+        for (const line of text.split("\n").filter(Boolean)) {
+          options.onOutput(line);
+        }
+      }
     });
     child.stdout?.on("data", (chunk) => {
       const text = chunk.toString();
-      const match = text.match(/(https:\/\/(?:vscode|cursor)\.dev\/tunnel\/[^\s]+)/);
+      if (options.onOutput) {
+        for (const line of text.split("\n").filter(Boolean)) {
+          options.onOutput(line);
+        }
+      }
+      const match = text.match(/(https:\/\/vscode\.dev\/tunnel\/[^\s]+)/);
       if (match) {
         clearTimeout(timer);
         settle(() => resolve({ url: match[1], process: child }));
@@ -647,7 +674,7 @@ program.command("status").description("Show task counts").action(() => {
   console.log(`  Gave up (!!!): ${counts.gaveUp}`);
   console.log("");
 });
-program.command("start").description("Start the daemon \u2014 continuously runs tasks from the queue").action(async () => {
+program.command("start").description("Start the daemon \u2014 continuously runs tasks from the queue").option("--no-tunnel", "Skip VS Code tunnel setup").action(async (opts) => {
   const check = preflight(process.cwd());
   for (const err of check.errors) {
     console.error(`  Error: ${err}`);
@@ -659,7 +686,63 @@ program.command("start").description("Start the daemon \u2014 continuously runs
     process.exit(1);
   }
   console.log("");
-  await runDaemon({ projectDir: process.cwd() });
+  let tunnelProc = null;
+  if (opts.tunnel) {
+    const editor = detectEditorCli();
+    if (editor === "cursor" || !isVSCodeAvailable()) {
+      if (isCursorDetected()) {
+        console.log("  Note: Remote tunnels only work with VS Code, not Cursor.");
+      } else {
+        console.log("  Note: VS Code CLI not found \u2014 skipping tunnel.");
+      }
+      console.log("  Tip: Enable remote control in your Claude Code settings to monitor sessions from claude.ai/code.");
+      console.log("");
+    } else {
+      const tunnelName = hostname();
+      console.log("  Starting VS Code tunnel...\n");
+      try {
+        const { url, process: tp } = await startTunnel(tunnelName, {
+          onOutput(line) {
+            const deviceCodeMatch = line.match(/use code\s+([A-Z0-9]{4}-[A-Z0-9]{4})/i);
+            const deviceUrlMatch = line.match(/(https:\/\/github\.com\/login\/device)/);
+            if (deviceCodeMatch || deviceUrlMatch) {
+              console.log("");
+              if (deviceUrlMatch) {
+                console.log(`  Open: ${deviceUrlMatch[1]}`);
+              }
+              if (deviceCodeMatch) {
+                console.log(`  Code: ${deviceCodeMatch[1]}`);
+              }
+              console.log("");
+            } else if (line.includes("Creating tunnel")) {
+              console.log(`  ${line.replace(/^\[.*?\]\s*\w+\s*/, "")}`);
+            }
+          }
+        });
+        tunnelProc = tp;
+        console.log("");
+        console.log(`  VS Code tunnel: ${url}`);
+        console.log("");
+        qrcode.generate(url, { small: true }, (code) => {
+          console.log(code);
+        });
+        console.log("  Scan QR to access editor remotely");
+        console.log("");
+      } catch (e) {
+        console.warn(`  Warning: Tunnel failed \u2014 ${e instanceof Error ? e.message : String(e)}`);
+        console.warn("  Continuing without tunnel.\n");
+      }
+    }
+  }
+  const cleanup = () => {
+    tunnelProc?.kill();
+    process.exit(0);
+  };
+  process.on("SIGINT", cleanup);
+  process.on("SIGTERM", cleanup);
+  await runDaemon({
+    projectDir: process.cwd()
+  });
 });
 program.command("add").description("Add a task to the queue").argument("<text>", "Task description").action((text) => {
   try {
@@ -688,18 +771,37 @@ program.command("reset").description("Reset all gave-up [!!!] tasks back to pend
   }
 });
 program.command("remote").description("Open a VS Code tunnel for phone access (QR code)").option("--name <name>", "Tunnel name").action(async (opts) => {
-  const tunnelName = opts.name ?? hostname();
-  let cli;
-  try {
-    cli = checkCodeCli();
-  } catch (e) {
-    console.error(e instanceof Error ? e.message : String(e));
+  if (isCursorDetected()) {
+    console.warn("  Warning: Remote tunnels only work with VS Code, not Cursor.");
+    console.warn("  Attempting anyway with VS Code CLI...\n");
+  }
+  if (!isVSCodeAvailable()) {
+    console.error(
+      '  Error: "code" CLI not found. Install VS Code or download the standalone CLI:\n  https://code.visualstudio.com/docs/editor/command-line'
+    );
     process.exit(1);
   }
-  const editorName = cli === "cursor" ? "Cursor" : "VS Code";
-  console.log(`Starting ${editorName} tunnel...`);
+  const tunnelName = opts.name ?? hostname();
+  console.log("Starting VS Code tunnel...\n");
   try {
-    const { url, process: tunnelProc } = await startTunnel(tunnelName, cli);
+    const { url, process: tunnelProc } = await startTunnel(tunnelName, {
+      onOutput(line) {
+        const deviceCodeMatch = line.match(/use code\s+([A-Z0-9]{4}-[A-Z0-9]{4})/i);
+        const deviceUrlMatch = line.match(/(https:\/\/github\.com\/login\/device)/);
+        if (deviceCodeMatch || deviceUrlMatch) {
+          console.log("");
+          if (deviceUrlMatch) {
+            console.log(`  Open: ${deviceUrlMatch[1]}`);
+          }
+          if (deviceCodeMatch) {
+            console.log(`  Code: ${deviceCodeMatch[1]}`);
+          }
+          console.log("");
+        } else if (line.includes("Creating tunnel")) {
+          console.log(`  ${line.replace(/^\[.*?\]\s*\w+\s*/, "")}`);
+        }
+      }
+    });
     console.log("");
     console.log(`  URL: ${url}`);
     console.log("");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trismegistus",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "A local persistent daemon that runs AI sessions from a task queue, with mobile support.",
   "type": "module",
   "bin": {