palmier 0.3.2 → 0.3.4

package/README.md

@@ -6,7 +6,7 @@
 
 **Website:** [palmier.me](https://www.palmier.me) | **App:** [app.palmier.me](https://app.palmier.me)
 
-A Node.js CLI that runs on your machine as a persistent daemon. It manages tasks, communicates with the Palmier app via NATS and/or direct HTTP, and executes tasks on schedule or demand using CLI tools.
+A Node.js CLI that runs on your machine as a persistent daemon. It lets you create, schedule, and run AI agent tasks from your phone or browser, communicating via a cloud relay (NATS) and/or direct HTTP.
 
 > **Important:** By using Palmier, you agree to the [Terms of Service](https://www.palmier.me/terms) and [Privacy Policy](https://www.palmier.me/privacy). See the [Disclaimer](#disclaimer) section below.
 
@@ -16,17 +16,17 @@ The host supports two independent connection modes, enabled during `palmier init
 
 | Mode | Transport | PWA URL | Features |
 |------|-----------|---------|----------|
-| **Server** | NATS (cloud relay) | `https://app.palmier.me` | Push notifications, remote access |
+| **Server** | Cloud relay (NATS) | `https://app.palmier.me` | Push notifications, remote access |
 | **LAN** | HTTP (direct, on-demand) | `http://<host-ip>:7400` | Low-latency, no external server needed |
 
-**Server mode** relays communication through the Palmier server via NATS. All features including push notifications are available. The PWA is served over HTTPS.
+**Server mode** relays communication through the Palmier cloud server (via [NATS](https://nats.io), a lightweight messaging system). All features including push notifications are available. The PWA is served over HTTPS.
 
 **LAN mode** is started on-demand via `palmier lan`. It runs a local HTTP server that reverse-proxies PWA assets from `app.palmier.me` and serves API endpoints locally. The browser accesses everything at `http://<host-ip>:<port>` (same-origin). Push notifications are not available in LAN mode.
 
 ## Prerequisites
 
 - **Node.js 24+**
-- An agent CLI tool for task execution (e.g., Claude Code, Gemini CLI, OpenAI Codex)
+- An agent CLI tool for task execution (e.g., Claude Code, Gemini CLI, OpenAI Codex, GitHub Copilot)
 - **Linux with systemd** or **Windows 10/11**
 
 ## Installation
@@ -35,6 +35,8 @@ The host supports two independent connection modes, enabled during `palmier init
 npm install -g palmier
 ```
 
+All `palmier` commands should be run from a dedicated Palmier root directory (e.g., `~/palmier`). This is where tasks, configuration, and execution data are stored.
+
 ## CLI Commands
 
 | Command | Description |
@@ -57,7 +59,7 @@ npm install -g palmier
 ### Quick Start
 
 1. Install the host: `npm install -g palmier`
-2. Run `palmier init` in your project directory.
+2. Run `palmier init` in your Palmier root directory (e.g., `~/palmier`).
 3. The wizard detects installed agents, registers with the Palmier server, installs a background daemon, and generates a pairing code.
 4. Enter the pairing code in the Palmier PWA to connect your device.
 
@@ -81,7 +83,7 @@ palmier sessions revoke-all
 ```
 
 The `init` command:
-- Detects installed agent CLIs (Claude Code, Gemini CLI, Codex CLI) and caches the result
+- Detects installed agent CLIs (Claude Code, Gemini CLI, Codex CLI, GitHub Copilot) and caches the result
 - Saves host configuration to `~/.config/palmier/host.json`
 - Installs a background daemon (systemd user service on Linux, Registry Run key on Windows)
 - Auto-enters pair mode to connect your first device
@@ -153,7 +155,6 @@ src/
   spawn-command.ts    # Shared helper for spawning CLI tools
   task.ts             # Task file management
   types.ts            # Shared type definitions
-  pairing.ts          # OTP code generation and expiry constant
   lan-lock.ts         # LAN lockfile path and port reader
   events.ts           # Event broadcasting (NATS pub/sub or HTTP SSE)
   agents/
@@ -161,6 +162,7 @@ src/
     claude.ts         # Claude Code agent implementation
     gemini.ts         # Gemini CLI agent implementation
     codex.ts          # Codex CLI agent implementation
+    copilot.ts        # GitHub Copilot agent implementation
     openclaw.ts       # OpenClaw agent implementation
   commands/
     init.ts           # Interactive setup wizard (auto-pair)
@@ -210,11 +212,11 @@ Requires a provisioned host (`palmier init`) with server mode enabled.
 |---|---|---|
 | `send-push-notification` | `title`, `body` (required) | Send a push notification to all paired devices |
 
-## Removing a Host
+## Uninstalling
 
-To fully remove a host from a machine:
+To fully remove Palmier from a machine:
 
-1. **Unpair the host from the PWA** (via the host menu).
+1. **Unpair your device** in the PWA (via the host menu).
 
 2. **Stop and remove the daemon:**
 
@@ -248,16 +250,11 @@ To fully remove a host from a machine:
    schtasks /delete /tn "PalmierTask-*" /f 2>$null
    ```
 
-4. **Remove the host configuration:**
+4. **Remove configuration and task data:**
 
    ```bash
    rm -rf ~/.config/palmier
-   ```
-
-5. **Remove the tasks directory** from your project root:
-
-   ```bash
-   rm -rf tasks/
+   rm -rf tasks/   # from your Palmier root directory
    ```
 
 ## Disclaimer

package/dist/agents/agent.js

@@ -2,17 +2,20 @@ import { ClaudeAgent } from "./claude.js";
 import { GeminiAgent } from "./gemini.js";
 import { CodexAgent } from "./codex.js";
 import { OpenClawAgent } from "./openclaw.js";
+import { CopilotAgent } from "./copilot.js";
 const agentRegistry = {
     claude: new ClaudeAgent(),
     gemini: new GeminiAgent(),
     codex: new CodexAgent(),
     openclaw: new OpenClawAgent(),
+    copilot: new CopilotAgent(),
 };
 const agentLabels = {
     claude: "Claude Code",
     gemini: "Gemini CLI",
     codex: "Codex CLI",
-    openclaw: "OpenClaw"
+    openclaw: "OpenClaw",
+    copilot: "GitHub Copilot",
 };
 export async function detectAgents() {
     const detected = [];

package/dist/agents/copilot.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedTask, RequiredPermission } from "../types.js";
+import type { AgentTool, CommandLine } from "./agent.js";
+export declare class CopilotAgent implements AgentTool {
+    getPlanGenerationCommandLine(prompt: string): CommandLine;
+    getTaskRunCommandLine(task: ParsedTask, retryPrompt?: string, extraPermissions?: RequiredPermission[]): CommandLine;
+    init(): Promise<boolean>;
+}
+//# sourceMappingURL=copilot.d.ts.map

package/dist/agents/copilot.js

@@ -0,0 +1,53 @@
+import * as fs from "fs";
+import * as path from "path";
+import { homedir } from "os";
+import { execSync } from "child_process";
+import { AGENT_INSTRUCTIONS } from "./shared-prompt.js";
+import { SHELL } from "../platform/index.js";
+export class CopilotAgent {
+    getPlanGenerationCommandLine(prompt) {
+        return {
+            command: "copilot",
+            args: ["-p", prompt],
+        };
+    }
+    getTaskRunCommandLine(task, retryPrompt, extraPermissions) {
+        const prompt = AGENT_INSTRUCTIONS + "\n\n" + (retryPrompt ?? (task.body || task.frontmatter.user_prompt));
+        const args = ["-p", prompt];
+        const allPerms = [...(task.frontmatter.permissions ?? []), ...(extraPermissions ?? [])];
+        if (allPerms.length > 0) {
+            args.push("--allow-tool", allPerms.map((p) => p.name).join(","));
+        }
+        if (retryPrompt) {
+            args.push("--continue");
+        }
+        return { command: "copilot", args };
+    }
+    async init() {
+        try {
+            execSync("gh copilot -v", { stdio: "ignore", shell: SHELL });
+        }
+        catch {
+            return false;
+        }
+        // Register Palmier MCP server in ~/.copilot/mcp-config.json
+        try {
+            const configDir = path.join(homedir(), ".copilot");
+            const configFile = path.join(configDir, "mcp-config.json");
+            let config = {};
+            if (fs.existsSync(configFile)) {
+                config = JSON.parse(fs.readFileSync(configFile, "utf-8"));
+            }
+            const servers = (config.mcpServers ?? {});
+            servers.palmier = { command: "palmier", args: ["mcpserver"] };
+            config.mcpServers = servers;
+            fs.mkdirSync(configDir, { recursive: true });
+            fs.writeFileSync(configFile, JSON.stringify(config, null, 2), "utf-8");
+        }
+        catch {
+            // MCP registration is best-effort
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=copilot.js.map

package/dist/commands/lan.js

@@ -2,7 +2,7 @@ import * as fs from "fs";
 import { loadConfig, CONFIG_DIR } from "../config.js";
 import { createRpcHandler } from "../rpc-handler.js";
 import { startHttpTransport, detectLanIp } from "../transports/http-transport.js";
-import { generatePairingCode } from "../pairing.js";
+import { generatePairingCode } from "./pair.js";
 import { LAN_LOCKFILE } from "../lan-lock.js";
 const bold = (s) => `\x1b[1m${s}\x1b[0m`;
 const cyan = (s) => `\x1b[36m${s}\x1b[0m`;

package/dist/commands/pair.d.ts

@@ -1,3 +1,5 @@
+export declare const PAIRING_EXPIRY_MS: number;
+export declare function generatePairingCode(): string;
 /**
  * Generate an OTP code and wait for a PWA client to pair.
  * Listens on NATS always, and also on the LAN server if `palmier lan` is running.

package/dist/commands/pair.js

@@ -3,8 +3,15 @@ import { StringCodec } from "nats";
 import { loadConfig } from "../config.js";
 import { connectNats } from "../nats-client.js";
 import { addSession } from "../session-store.js";
-import { generatePairingCode, PAIRING_EXPIRY_MS } from "../pairing.js";
 import { getLanPort } from "../lan-lock.js";
+const CODE_CHARS = "ABCDEFGHJKMNPQRSTUVWXYZ23456789"; // no O/0/I/1/L
+const CODE_LENGTH = 6;
+export const PAIRING_EXPIRY_MS = 5 * 60 * 1000; // 5 minutes
+export function generatePairingCode() {
+    const bytes = new Uint8Array(CODE_LENGTH);
+    crypto.getRandomValues(bytes);
+    return Array.from(bytes, (b) => CODE_CHARS[b % CODE_CHARS.length]).join("");
+}
 function buildPairResponse(config, label) {
     const session = addSession(label);
     return {

package/dist/platform/windows.js

@@ -15,47 +15,69 @@ function schtasksTr(...subcommand) {
     const script = process.argv[1] || "palmier";
     return `"${process.execPath}" "${script}" ${subcommand.join(" ")}`;
 }
+const DOW_NAMES = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"];
 /**
- * Convert one of the 4 supported cron patterns to schtasks flags.
+ * Convert a cron expression or "once" trigger to Task Scheduler XML trigger elements.
  *
- * Only these patterns (produced by the PWA UI) are handled:
- *   hourly:  "0 * * * *"        → /sc HOURLY
- *   daily:   "MM HH * * *"      → /sc DAILY /st HH:MM
- *   weekly:  "MM HH * * D"      → /sc WEEKLY /d <day> /st HH:MM
- *   monthly: "MM HH D * *"      → /sc MONTHLY /d D /st HH:MM
- *
- * Arbitrary cron expressions (ranges, lists, step values) are NOT handled
- * because the UI never generates them.
+ * Only these cron patterns (produced by the PWA UI) are handled:
+ *   hourly:  "0 * * * *"
+ *   daily:   "MM HH * * *"
+ *   weekly:  "MM HH * * D"
+ *   monthly: "MM HH D * *"
  */
-function cronToSchtasksArgs(cron) {
-    const parts = cron.trim().split(/\s+/);
-    if (parts.length !== 5) {
-        throw new Error(`Invalid cron expression (expected 5 fields): ${cron}`);
+function triggerToXml(trigger) {
+    if (trigger.type === "once") {
+        // ISO datetime "2026-03-28T09:00"
+        return `<TimeTrigger><StartBoundary>${trigger.value}:00</StartBoundary></TimeTrigger>`;
     }
+    const parts = trigger.value.trim().split(/\s+/);
+    if (parts.length !== 5)
+        throw new Error(`Invalid cron expression: ${trigger.value}`);
     const [minute, hour, dayOfMonth, , dayOfWeek] = parts;
-    // Map cron day-of-week numbers to schtasks day abbreviations
-    const dowMap = {
-        "0": "SUN", "1": "MON", "2": "TUE", "3": "WED",
-        "4": "THU", "5": "FRI", "6": "SAT", "7": "SUN",
-    };
-    const st = `${hour.padStart(2, "0")}:${minute.padStart(2, "0")}`;
-    // Hourly: "0 * * * *"
-    if (hour === "*" && dayOfMonth === "*" && dayOfWeek === "*") {
-        return ["/sc", "HOURLY"];
+    const st = `${hour.padStart(2, "0")}:${minute.padStart(2, "0")}:00`;
+    // StartBoundary needs a full date; use a past date as the anchor
+    const base = `2000-01-01T${st}`;
+    // Hourly
+    if (hour === "*") {
+        return `<TimeTrigger><StartBoundary>${base}</StartBoundary><Repetition><Interval>PT1H</Interval></Repetition></TimeTrigger>`;
     }
-    // Weekly: "MM HH * * D"
+    // Weekly
     if (dayOfMonth === "*" && dayOfWeek !== "*") {
-        const day = dowMap[dayOfWeek];
-        if (!day)
-            throw new Error(`Unsupported day-of-week: ${dayOfWeek}`);
-        return ["/sc", "WEEKLY", "/d", day, "/st", st];
+        const day = DOW_NAMES[Number(dayOfWeek)] ?? "Monday";
+        return `<CalendarTrigger><StartBoundary>${base}</StartBoundary><ScheduleByWeek><DaysOfWeek><${day} /></DaysOfWeek><WeeksInterval>1</WeeksInterval></ScheduleByWeek></CalendarTrigger>`;
     }
-    // Monthly: "MM HH D * *"
+    // Monthly
     if (dayOfMonth !== "*" && dayOfWeek === "*") {
-        return ["/sc", "MONTHLY", "/d", dayOfMonth, "/st", st];
+        return `<CalendarTrigger><StartBoundary>${base}</StartBoundary><ScheduleByMonth><DaysOfMonth><Day>${dayOfMonth}</Day></DaysOfMonth><Months><January /><February /><March /><April /><May /><June /><July /><August /><September /><October /><November /><December /></Months></ScheduleByMonth></CalendarTrigger>`;
     }
-    // Daily: "MM HH * * *"  (most common fallback)
-    return ["/sc", "DAILY", "/st", st];
+    // Daily
+    return `<CalendarTrigger><StartBoundary>${base}</StartBoundary><ScheduleByDay><DaysInterval>1</DaysInterval></ScheduleByDay></CalendarTrigger>`;
+}
+/**
+ * Build a complete Task Scheduler XML definition.
+ */
+function buildTaskXml(tr, triggers) {
+    const [command, ...argParts] = tr.match(/"[^"]*"|[^\s]+/g) ?? [];
+    const commandStr = command?.replace(/"/g, "") ?? "";
+    const argsStr = argParts.map((a) => a.replace(/"/g, "")).join(" ");
+    return [
+        `<?xml version="1.0" encoding="UTF-16"?>`,
+        `<Task version="1.3" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">`,
+        `  <Settings>`,
+        `    <MultipleInstancesPolicy>StopExisting</MultipleInstancesPolicy>`,
+        `    <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>`,
+        `    <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>`,
+        `    <UseUnifiedSchedulingEngine>true</UseUnifiedSchedulingEngine>`,
+        `  </Settings>`,
+        `  <Triggers>${triggers.join("")}</Triggers>`,
+        `  <Actions>`,
+        `    <Exec>`,
+        `      <Command>${commandStr}</Command>`,
+        `      <Arguments>${argsStr}</Arguments>`,
+        `    </Exec>`,
+        `  </Actions>`,
+        `</Task>`,
+    ].join("\n");
 }
 function schtasksTaskName(taskId) {
     return `${TASK_PREFIX}${taskId}`;
@@ -63,8 +85,9 @@ function schtasksTaskName(taskId) {
 export class WindowsPlatform {
     installDaemon(config) {
         const script = process.argv[1] || "palmier";
-        // Write a VBS launcher that starts the daemon with no visible console window
-        const vbs = `CreateObject("WScript.Shell").Run """${process.execPath.replace(/\\/g, "\\\\")}"" ""${script.replace(/\\/g, "\\\\")}"" serve", 0, False`;
+        // Write a VBS launcher that starts the daemon with no visible console window.
+        // VBS doesn't use backslash escaping — only quotes need doubling ("").
+        const vbs = `CreateObject("WScript.Shell").Run """${process.execPath}"" ""${script}"" serve", 0, False`;
         fs.writeFileSync(DAEMON_VBS_FILE, vbs, "utf-8");
         const regValue = `"${process.env.SYSTEMROOT || "C:\\Windows"}\\System32\\wscript.exe" "${DAEMON_VBS_FILE}"`;
         try {
@@ -112,64 +135,43 @@ export class WindowsPlatform {
         const taskId = task.frontmatter.id;
         const tn = schtasksTaskName(taskId);
         const tr = schtasksTr("run", taskId);
-        // Always create the scheduled task with a dummy trigger first.
-        // This ensures startTask (/run) works even when no triggers are configured.
+        // Build trigger XML elements
+        const triggerElements = [];
+        if (task.frontmatter.triggers_enabled) {
+            for (const trigger of task.frontmatter.triggers ?? []) {
+                try {
+                    triggerElements.push(triggerToXml(trigger));
+                }
+                catch (err) {
+                    console.error(`Invalid trigger: ${err}`);
+                }
+            }
+        }
+        // Always include a dummy trigger so startTask (/run) works
+        if (triggerElements.length === 0) {
+            triggerElements.push(`<TimeTrigger><StartBoundary>2000-01-01T00:00:00</StartBoundary></TimeTrigger>`);
+        }
+        // Write XML and register via schtasks — gives us full control over
+        // settings like MultipleInstancesPolicy that schtasks flags don't expose.
+        const xml = buildTaskXml(tr, triggerElements);
+        const xmlPath = path.join(CONFIG_DIR, `task-${taskId}.xml`);
         try {
+            // schtasks /xml requires UTF-16LE with BOM
+            const bom = Buffer.from([0xFF, 0xFE]);
+            fs.writeFileSync(xmlPath, Buffer.concat([bom, Buffer.from(xml, "utf16le")]));
             execFileSync("schtasks", [
-                "/create", "/tn", tn,
-                "/tr", tr,
-                "/sc", "ONCE", "/sd", "01/01/2000", "/st", "00:00",
-                "/f",
+                "/create", "/tn", tn, "/xml", xmlPath, "/f",
             ], { encoding: "utf-8", windowsHide: true });
         }
         catch (err) {
             const e = err;
             console.error(`Failed to create scheduled task ${tn}: ${e.stderr || err}`);
         }
-        // Overlay with real schedule triggers if enabled
-        if (!task.frontmatter.triggers_enabled)
-            return;
-        const triggers = task.frontmatter.triggers || [];
-        for (const trigger of triggers) {
-            if (trigger.type === "cron") {
-                const schedArgs = cronToSchtasksArgs(trigger.value);
-                try {
-                    execFileSync("schtasks", [
-                        "/create", "/tn", tn,
-                        "/tr", tr,
-                        ...schedArgs,
-                        "/f",
-                    ], { encoding: "utf-8", windowsHide: true });
-                }
-                catch (err) {
-                    const e = err;
-                    console.error(`Failed to create scheduled task ${tn}: ${e.stderr || err}`);
-                }
-            }
-            else if (trigger.type === "once") {
-                // "once" triggers use ISO datetime: "2026-03-28T09:00"
-                const [datePart, timePart] = trigger.value.split("T");
-                if (!datePart || !timePart) {
-                    console.error(`Invalid once trigger value: ${trigger.value}`);
-                    continue;
-                }
-                // schtasks expects MM/DD/YYYY date format
-                const [year, month, day] = datePart.split("-");
-                const sd = `${month}/${day}/${year}`;
-                const st = timePart.slice(0, 5);
-                try {
-                    execFileSync("schtasks", [
-                        "/create", "/tn", tn,
-                        "/tr", tr,
-                        "/sc", "ONCE", "/sd", sd, "/st", st,
-                        "/f",
-                    ], { encoding: "utf-8", windowsHide: true });
-                }
-                catch (err) {
-                    const e = err;
-                    console.error(`Failed to create once task ${tn}: ${e.stderr || err}`);
-                }
+        finally {
+            try {
+                fs.unlinkSync(xmlPath);
             }
+            catch { /* ignore */ }
         }
     }
     removeTaskTimer(taskId) {

package/dist/update-checker.d.ts

@@ -1,3 +1,5 @@
+/** True when running from a source checkout (has .git) rather than a global npm install. */
+export declare const isDevBuild: boolean;
 export declare const currentVersion: string;
 /**
  * Check the npm registry for the latest version of palmier.

package/dist/update-checker.js

@@ -4,8 +4,11 @@ import { fileURLToPath } from "url";
 import { spawnCommand } from "./spawn-command.js";
 import { getPlatform } from "./platform/index.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf-8"));
-export const currentVersion = pkg.version;
+const packageRoot = path.join(__dirname, "..");
+const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf-8"));
+/** True when running from a source checkout (has .git) rather than a global npm install. */
+export const isDevBuild = fs.existsSync(path.join(packageRoot, ".git"));
+export const currentVersion = isDevBuild ? `${pkg.version}-dev` : pkg.version;
 let latestVersion = null;
 let lastCheckTime = 0;
 const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
@@ -13,6 +16,8 @@ const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
  * Check the npm registry for the latest version of palmier.
  */
 export async function checkForUpdate() {
+    if (isDevBuild)
+        return;
     const now = Date.now();
     if (now - lastCheckTime < CHECK_INTERVAL_MS)
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "palmier",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Palmier host CLI - provisions, executes tasks, and serves NATS RPC",
   "license": "Apache-2.0",
   "author": "Hongxu Cai",

package/src/agents/agent.ts

@@ -3,6 +3,7 @@ import { ClaudeAgent } from "./claude.js";
 import { GeminiAgent } from "./gemini.js";
 import { CodexAgent } from "./codex.js";
 import { OpenClawAgent } from "./openclaw.js";
+import { CopilotAgent } from "./copilot.js";
 
 export interface CommandLine {
   command: string;
@@ -34,13 +35,15 @@ const agentRegistry: Record<string, AgentTool> = {
   gemini: new GeminiAgent(),
   codex: new CodexAgent(),
   openclaw: new OpenClawAgent(),
+  copilot: new CopilotAgent(),
 };
 
 const agentLabels: Record<string, string> = {
   claude: "Claude Code",
   gemini: "Gemini CLI",
   codex: "Codex CLI",
-  openclaw: "OpenClaw"
+  openclaw: "OpenClaw",
+  copilot: "GitHub Copilot",
 };
 
 export interface DetectedAgent {

package/src/agents/copilot.ts

@@ -0,0 +1,55 @@
+import * as fs from "fs";
+import * as path from "path";
+import { homedir } from "os";
+import type { ParsedTask, RequiredPermission } from "../types.js";
+import { execSync } from "child_process";
+import type { AgentTool, CommandLine } from "./agent.js";
+import { AGENT_INSTRUCTIONS } from "./shared-prompt.js";
+import { SHELL } from "../platform/index.js";
+
+export class CopilotAgent implements AgentTool {
+  getPlanGenerationCommandLine(prompt: string): CommandLine {
+    return {
+      command: "copilot",
+      args: ["-p", prompt],
+    };
+  }
+
+  getTaskRunCommandLine(task: ParsedTask, retryPrompt?: string, extraPermissions?: RequiredPermission[]): CommandLine {
+    const prompt = AGENT_INSTRUCTIONS + "\n\n" + (retryPrompt ?? (task.body || task.frontmatter.user_prompt));
+    const args = ["-p", prompt];
+
+    const allPerms = [...(task.frontmatter.permissions ?? []), ...(extraPermissions ?? [])];
+    if (allPerms.length > 0) {
+      args.push("--allow-tool", allPerms.map((p) => p.name).join(","));
+    }
+
+    if (retryPrompt) { args.push("--continue"); }
+    return { command: "copilot", args};
+  }
+
+  async init(): Promise<boolean> {
+    try {
+      execSync("gh copilot -v", { stdio: "ignore", shell: SHELL });
+    } catch {
+      return false;
+    }
+    // Register Palmier MCP server in ~/.copilot/mcp-config.json
+    try {
+      const configDir = path.join(homedir(), ".copilot");
+      const configFile = path.join(configDir, "mcp-config.json");
+      let config: Record<string, unknown> = {};
+      if (fs.existsSync(configFile)) {
+        config = JSON.parse(fs.readFileSync(configFile, "utf-8")) as Record<string, unknown>;
+      }
+      const servers = (config.mcpServers ?? {}) as Record<string, unknown>;
+      servers.palmier = { command: "palmier", args: ["mcpserver"] };
+      config.mcpServers = servers;
+      fs.mkdirSync(configDir, { recursive: true });
+      fs.writeFileSync(configFile, JSON.stringify(config, null, 2), "utf-8");
+    } catch {
+      // MCP registration is best-effort
+    }
+    return true;
+  }
+}

package/src/commands/lan.ts

@@ -2,7 +2,7 @@ import * as fs from "fs";
 import { loadConfig, CONFIG_DIR } from "../config.js";
 import { createRpcHandler } from "../rpc-handler.js";
 import { startHttpTransport, detectLanIp } from "../transports/http-transport.js";
-import { generatePairingCode } from "../pairing.js";
+import { generatePairingCode } from "./pair.js";
 import { LAN_LOCKFILE } from "../lan-lock.js";
 
 const bold = (s: string) => `\x1b[1m${s}\x1b[0m`;

package/src/commands/pair.ts

@@ -3,10 +3,20 @@ import { StringCodec } from "nats";
 import { loadConfig } from "../config.js";
 import { connectNats } from "../nats-client.js";
 import { addSession } from "../session-store.js";
-import { generatePairingCode, PAIRING_EXPIRY_MS } from "../pairing.js";
 import { getLanPort } from "../lan-lock.js";
 import type { HostConfig } from "../types.js";
 
+const CODE_CHARS = "ABCDEFGHJKMNPQRSTUVWXYZ23456789"; // no O/0/I/1/L
+const CODE_LENGTH = 6;
+
+export const PAIRING_EXPIRY_MS = 5 * 60 * 1000; // 5 minutes
+
+export function generatePairingCode(): string {
+  const bytes = new Uint8Array(CODE_LENGTH);
+  crypto.getRandomValues(bytes);
+  return Array.from(bytes, (b) => CODE_CHARS[b % CODE_CHARS.length]).join("");
+}
+
 function buildPairResponse(config: HostConfig, label?: string) {
   const session = addSession(label);
   return {

package/src/platform/windows.ts

@@ -21,53 +21,76 @@ function schtasksTr(...subcommand: string[]): string {
   return `"${process.execPath}" "${script}" ${subcommand.join(" ")}`;
 }
 
+const DOW_NAMES = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"];
+
 /**
- * Convert one of the 4 supported cron patterns to schtasks flags.
- *
- * Only these patterns (produced by the PWA UI) are handled:
- *   hourly:  "0 * * * *"        → /sc HOURLY
- *   daily:   "MM HH * * *"      → /sc DAILY /st HH:MM
- *   weekly:  "MM HH * * D"      → /sc WEEKLY /d <day> /st HH:MM
- *   monthly: "MM HH D * *"      → /sc MONTHLY /d D /st HH:MM
+ * Convert a cron expression or "once" trigger to Task Scheduler XML trigger elements.
  *
- * Arbitrary cron expressions (ranges, lists, step values) are NOT handled
- * because the UI never generates them.
+ * Only these cron patterns (produced by the PWA UI) are handled:
+ *   hourly:  "0 * * * *"
+ *   daily:   "MM HH * * *"
+ *   weekly:  "MM HH * * D"
+ *   monthly: "MM HH D * *"
  */
-function cronToSchtasksArgs(cron: string): string[] {
-  const parts = cron.trim().split(/\s+/);
-  if (parts.length !== 5) {
-    throw new Error(`Invalid cron expression (expected 5 fields): ${cron}`);
+function triggerToXml(trigger: { type: string; value: string }): string {
+  if (trigger.type === "once") {
+    // ISO datetime "2026-03-28T09:00"
+    return `<TimeTrigger><StartBoundary>${trigger.value}:00</StartBoundary></TimeTrigger>`;
   }
 
+  const parts = trigger.value.trim().split(/\s+/);
+  if (parts.length !== 5) throw new Error(`Invalid cron expression: ${trigger.value}`);
   const [minute, hour, dayOfMonth, , dayOfWeek] = parts;
+  const st = `${hour.padStart(2, "0")}:${minute.padStart(2, "0")}:00`;
+  // StartBoundary needs a full date; use a past date as the anchor
+  const base = `2000-01-01T${st}`;
 
-  // Map cron day-of-week numbers to schtasks day abbreviations
-  const dowMap: Record<string, string> = {
-    "0": "SUN", "1": "MON", "2": "TUE", "3": "WED",
-    "4": "THU", "5": "FRI", "6": "SAT", "7": "SUN",
-  };
-
-  const st = `${hour.padStart(2, "0")}:${minute.padStart(2, "0")}`;
-
-  // Hourly: "0 * * * *"
-  if (hour === "*" && dayOfMonth === "*" && dayOfWeek === "*") {
-    return ["/sc", "HOURLY"];
+  // Hourly
+  if (hour === "*") {
+    return `<TimeTrigger><StartBoundary>${base}</StartBoundary><Repetition><Interval>PT1H</Interval></Repetition></TimeTrigger>`;
   }
 
-  // Weekly: "MM HH * * D"
+  // Weekly
   if (dayOfMonth === "*" && dayOfWeek !== "*") {
-    const day = dowMap[dayOfWeek];
-    if (!day) throw new Error(`Unsupported day-of-week: ${dayOfWeek}`);
-    return ["/sc", "WEEKLY", "/d", day, "/st", st];
+    const day = DOW_NAMES[Number(dayOfWeek)] ?? "Monday";
+    return `<CalendarTrigger><StartBoundary>${base}</StartBoundary><ScheduleByWeek><DaysOfWeek><${day} /></DaysOfWeek><WeeksInterval>1</WeeksInterval></ScheduleByWeek></CalendarTrigger>`;
   }
 
-  // Monthly: "MM HH D * *"
+  // Monthly
   if (dayOfMonth !== "*" && dayOfWeek === "*") {
-    return ["/sc", "MONTHLY", "/d", dayOfMonth, "/st", st];
+    return `<CalendarTrigger><StartBoundary>${base}</StartBoundary><ScheduleByMonth><DaysOfMonth><Day>${dayOfMonth}</Day></DaysOfMonth><Months><January /><February /><March /><April /><May /><June /><July /><August /><September /><October /><November /><December /></Months></ScheduleByMonth></CalendarTrigger>`;
   }
 
-  // Daily: "MM HH * * *"  (most common fallback)
-  return ["/sc", "DAILY", "/st", st];
+  // Daily
+  return `<CalendarTrigger><StartBoundary>${base}</StartBoundary><ScheduleByDay><DaysInterval>1</DaysInterval></ScheduleByDay></CalendarTrigger>`;
+}
+
+/**
+ * Build a complete Task Scheduler XML definition.
+ */
+function buildTaskXml(tr: string, triggers: string[]): string {
+  const [command, ...argParts] = tr.match(/"[^"]*"|[^\s]+/g) ?? [];
+  const commandStr = command?.replace(/"/g, "") ?? "";
+  const argsStr = argParts.map((a) => a.replace(/"/g, "")).join(" ");
+
+  return [
+    `<?xml version="1.0" encoding="UTF-16"?>`,
+    `<Task version="1.3" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">`,
+    `  <Settings>`,
+    `    <MultipleInstancesPolicy>StopExisting</MultipleInstancesPolicy>`,
+    `    <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>`,
+    `    <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>`,
+    `    <UseUnifiedSchedulingEngine>true</UseUnifiedSchedulingEngine>`,
+    `  </Settings>`,
+    `  <Triggers>${triggers.join("")}</Triggers>`,
+    `  <Actions>`,
+    `    <Exec>`,
+    `      <Command>${commandStr}</Command>`,
+    `      <Arguments>${argsStr}</Arguments>`,
+    `    </Exec>`,
+    `  </Actions>`,
+    `</Task>`,
+  ].join("\n");
 }
 
 function schtasksTaskName(taskId: string): string {
@@ -78,8 +101,9 @@ export class WindowsPlatform implements PlatformService {
   installDaemon(config: HostConfig): void {
     const script = process.argv[1] || "palmier";
 
-    // Write a VBS launcher that starts the daemon with no visible console window
-    const vbs = `CreateObject("WScript.Shell").Run """${process.execPath.replace(/\\/g, "\\\\")}"" ""${script.replace(/\\/g, "\\\\")}"" serve", 0, False`;
+    // Write a VBS launcher that starts the daemon with no visible console window.
+    // VBS doesn't use backslash escaping — only quotes need doubling ("").
+    const vbs = `CreateObject("WScript.Shell").Run """${process.execPath}"" ""${script}"" serve", 0, False`;
     fs.writeFileSync(DAEMON_VBS_FILE, vbs, "utf-8");
 
     const regValue = `"${process.env.SYSTEMROOT || "C:\\Windows"}\\System32\\wscript.exe" "${DAEMON_VBS_FILE}"`;
@@ -134,60 +158,38 @@ export class WindowsPlatform implements PlatformService {
     const tn = schtasksTaskName(taskId);
     const tr = schtasksTr("run", taskId);
 
-    // Always create the scheduled task with a dummy trigger first.
-    // This ensures startTask (/run) works even when no triggers are configured.
+    // Build trigger XML elements
+    const triggerElements: string[] = [];
+    if (task.frontmatter.triggers_enabled) {
+      for (const trigger of task.frontmatter.triggers ?? []) {
+        try {
+          triggerElements.push(triggerToXml(trigger));
+        } catch (err) {
+          console.error(`Invalid trigger: ${err}`);
+        }
+      }
+    }
+    // Always include a dummy trigger so startTask (/run) works
+    if (triggerElements.length === 0) {
+      triggerElements.push(`<TimeTrigger><StartBoundary>2000-01-01T00:00:00</StartBoundary></TimeTrigger>`);
+    }
+
+    // Write XML and register via schtasks — gives us full control over
+    // settings like MultipleInstancesPolicy that schtasks flags don't expose.
+    const xml = buildTaskXml(tr, triggerElements);
+    const xmlPath = path.join(CONFIG_DIR, `task-${taskId}.xml`);
     try {
+      // schtasks /xml requires UTF-16LE with BOM
+      const bom = Buffer.from([0xFF, 0xFE]);
+      fs.writeFileSync(xmlPath, Buffer.concat([bom, Buffer.from(xml, "utf16le")]));
       execFileSync("schtasks", [
-        "/create", "/tn", tn,
-        "/tr", tr,
-        "/sc", "ONCE", "/sd", "01/01/2000", "/st", "00:00",
-        "/f",
+        "/create", "/tn", tn, "/xml", xmlPath, "/f",
       ], { encoding: "utf-8", windowsHide: true });
     } catch (err: unknown) {
       const e = err as { stderr?: string };
       console.error(`Failed to create scheduled task ${tn}: ${e.stderr || err}`);
-    }
-
-    // Overlay with real schedule triggers if enabled
-    if (!task.frontmatter.triggers_enabled) return;
-    const triggers = task.frontmatter.triggers || [];
-    for (const trigger of triggers) {
-      if (trigger.type === "cron") {
-        const schedArgs = cronToSchtasksArgs(trigger.value);
-        try {
-          execFileSync("schtasks", [
-            "/create", "/tn", tn,
-            "/tr", tr,
-            ...schedArgs,
-            "/f",
-          ], { encoding: "utf-8", windowsHide: true });
-        } catch (err: unknown) {
-          const e = err as { stderr?: string };
-          console.error(`Failed to create scheduled task ${tn}: ${e.stderr || err}`);
-        }
-      } else if (trigger.type === "once") {
-        // "once" triggers use ISO datetime: "2026-03-28T09:00"
-        const [datePart, timePart] = trigger.value.split("T");
-        if (!datePart || !timePart) {
-          console.error(`Invalid once trigger value: ${trigger.value}`);
-          continue;
-        }
-        // schtasks expects MM/DD/YYYY date format
-        const [year, month, day] = datePart.split("-");
-        const sd = `${month}/${day}/${year}`;
-        const st = timePart.slice(0, 5);
-        try {
-          execFileSync("schtasks", [
-            "/create", "/tn", tn,
-            "/tr", tr,
-            "/sc", "ONCE", "/sd", sd, "/st", st,
-            "/f",
-          ], { encoding: "utf-8", windowsHide: true });
-        } catch (err: unknown) {
-          const e = err as { stderr?: string };
-          console.error(`Failed to create once task ${tn}: ${e.stderr || err}`);
-        }
-      }
+    } finally {
+      try { fs.unlinkSync(xmlPath); } catch { /* ignore */ }
     }
   }
 

package/src/update-checker.ts

@@ -5,8 +5,12 @@ import { spawnCommand } from "./spawn-command.js";
 import { getPlatform } from "./platform/index.js";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf-8")) as { version: string };
-export const currentVersion = pkg.version;
+const packageRoot = path.join(__dirname, "..");
+const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf-8")) as { version: string };
+
+/** True when running from a source checkout (has .git) rather than a global npm install. */
+export const isDevBuild = fs.existsSync(path.join(packageRoot, ".git"));
+export const currentVersion = isDevBuild ? `${pkg.version}-dev` : pkg.version;
 
 let latestVersion: string | null = null;
 let lastCheckTime = 0;
@@ -16,6 +20,7 @@ const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
  * Check the npm registry for the latest version of palmier.
  */
 export async function checkForUpdate(): Promise<void> {
+  if (isDevBuild) return;
   const now = Date.now();
   if (now - lastCheckTime < CHECK_INTERVAL_MS) return;
   lastCheckTime = now;

package/dist/pairing.d.ts

@@ -1,3 +0,0 @@
-export declare const PAIRING_EXPIRY_MS: number;
-export declare function generatePairingCode(): string;
-//# sourceMappingURL=pairing.d.ts.map

package/dist/pairing.js

@@ -1,9 +0,0 @@
-const CODE_CHARS = "ABCDEFGHJKMNPQRSTUVWXYZ23456789"; // no O/0/I/1/L
-const CODE_LENGTH = 6;
-export const PAIRING_EXPIRY_MS = 5 * 60 * 1000; // 5 minutes
-export function generatePairingCode() {
-    const bytes = new Uint8Array(CODE_LENGTH);
-    crypto.getRandomValues(bytes);
-    return Array.from(bytes, (b) => CODE_CHARS[b % CODE_CHARS.length]).join("");
-}
-//# sourceMappingURL=pairing.js.map

package/src/pairing.ts

@@ -1,10 +0,0 @@
-const CODE_CHARS = "ABCDEFGHJKMNPQRSTUVWXYZ23456789"; // no O/0/I/1/L
-const CODE_LENGTH = 6;
-
-export const PAIRING_EXPIRY_MS = 5 * 60 * 1000; // 5 minutes
-
-export function generatePairingCode(): string {
-  const bytes = new Uint8Array(CODE_LENGTH);
-  crypto.getRandomValues(bytes);
-  return Array.from(bytes, (b) => CODE_CHARS[b % CODE_CHARS.length]).join("");
-}