palmier 0.9.22 → 0.9.23

package/README.md

@@ -6,30 +6,23 @@
 
 **Website:** [palmier.me](https://www.palmier.me) | **Web App:** [app.palmier.me](https://app.palmier.me) | **Android App:** [caihongxu/palmier-android](https://github.com/caihongxu/palmier-android)
 
-**Free AI agents, right from your phone.**
+Palmier installs, manages, and runs AI agent CLIs (Claude Code, Gemini CLI, Codex, etc.) on your machine using your existing AI subscriptions, and exposes them to your phone through a mobile-friendly PWA and an Android app. It runs as a background daemon and is agent-agnostic — adding support for a new CLI is a config change, not a code change.
 
-Palmier runs AI agents on your computer using the AI subscriptions you already have, then lets you start or schedule tasks, check progress, and respond to requests from your phone. It also gives your agents access to phone-side capabilities — calendar, contacts, notifications, location, SMS, alarms — so they can react to the real world, not just the terminal.
+The control surface is bidirectional:
 
-Palmier is free, open source, and requires no account or API key. It runs as a background daemon on your machine and pairs with a mobile-friendly PWA or the Android app (iOS coming soon).
+* **Phone → host:** start ad-hoc sessions, register schedule- or event-triggered tasks, inspect session output, and respond to agent input/confirmation requests.
+* **Host → phone:** agents can call MCP tools to read device state (location, calendar, contacts, notifications, SMS, battery) and trigger actions (push notifications, full-screen alarms, SMS, email, contact/calendar writes, ringer mode).
 
-## What Palmier does
-
-* **Your phone becomes an agent remote** — start, schedule, monitor, and respond to agent tasks without being at your computer. On the same network, the Android app connects over LAN automatically for lower latency.
-* **Agent access to your phone data** — give agents access to your phone's location, calendar, contacts, notifications, and SMS. They can also send email on your behalf, send you push notifications, and ask for your input when needed. (Phone capabilities require the Android app.)
-* **Free with your existing AI subscriptions** — Palmier installs/detects agent CLIs and invokes them, so Claude Pro, Gemini, ChatGPT Plus, and [more](https://www.palmier.me/agents) just work. No extra account, no extra API key.
-* **Task scheduling** — run tasks on a schedule, on demand, or in response to events (e.g. when a push notification arrives), using native OS schedulers (systemd, launchd, Task Scheduler).
-* **You stay in control** — agents can only access phone capabilities you enable; approve requests from your phone, or enable yolo mode to auto-approve.
-* **Your agents, your machine** — agents run on your hardware, not ours. Your data stays on your machine. No account required.
+Capability access is opt-in per device: each MCP tool is gated behind an Android permission and a per-host toggle. An optional yolo mode auto-approves agent input/confirmation requests.
 
 It is not:
 
-* an agent runtime itself
-* a system for driving your phone UI like a human tapping through apps
+* an agent runtime itself — Palmier shells out to the agent CLI and streams its stdio
+* a system for driving phone UI like a human tapping through apps — phone access is via OS-level APIs (FCM data messages, content providers, calendar/contacts APIs), not UI automation
 
 ## Quick Start
 
-1. Install a supported agent CLI — [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [Codex CLI](https://github.com/openai/codex), [GitHub Copilot](https://github.com/github/gh-copilot), [OpenClaw](https://openclaw.ai/), or [others](https://www.palmier.me/agents).
-2. Install Palmier:
+1. Install Palmier:
 
    **Linux / macOS:**
    ```bash
@@ -45,19 +38,18 @@ It is not:
    ```bash
    npm install -g palmier
    ```
-3. Run the setup wizard from your Palmier root directory (e.g., `~/palmier`):
+2. Run the setup wizard from your Palmier root directory (e.g., `~/palmier`):
    ```bash
    palmier init
    ```
-   This detects your agents, configures access, installs the background daemon, and starts pairing.
-4. Open `http://localhost:7256` to access the app locally — no pairing needed.
-5. To access from other devices, enter the pairing code shown after init into the [PWA](https://app.palmier.me) or the [Android app](https://github.com/caihongxu/palmier-android/releases/latest/download/palmier.apk).
+   This detects existing agent CLIs or offers to install supported ones ([Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [Codex CLI](https://github.com/openai/codex), [GitHub Copilot](https://github.com/github/gh-copilot), [OpenClaw](https://openclaw.ai/), or [others](https://www.palmier.me/agents)), configures access, installs the background daemon, and starts pairing.
+3. Open `http://localhost:7256` to access the app locally — no pairing needed.
+4. To access from other devices, enter the pairing code shown after init into the [PWA](https://app.palmier.me) or the [Android app](https://github.com/caihongxu/palmier-android/releases/latest/download/palmier.apk).
 
 ### Prerequisites
 
 - **Node.js 24+**
 - **Linux with systemd**, **macOS 13+**, or **Windows 10/11**
-- At least one supported agent CLI
 
 ## How It Works
 
@@ -220,7 +212,7 @@ The default network interface is detected once during `palmier init` and saved t
 | `palmier serve` | Run the persistent RPC handler (default command) |
 | `palmier restart` | Restart the palmier serve daemon |
 | `palmier run <task-id>` | Execute a specific task |
-| `palmier uninstall` | Stop daemon and remove all scheduled tasks |
+| `palmier uninstall` | Stop daemon, remove all scheduled tasks, and uninstall Palmier-managed agent CLIs |
 
 ## Uninstalling
 
@@ -228,12 +220,14 @@ To fully remove Palmier from a machine:
 
 1. **Unpair your device** in the PWA (via the host menu).
 
-2. **Stop the daemon and remove all scheduled tasks:**
+2. **Stop the daemon, remove all scheduled tasks, and uninstall Palmier-managed agent CLIs:**
 
    ```bash
    palmier uninstall
    ```
 
+   Agents you installed yourself outside Palmier (no managed version stamp) are left in place.
+
 3. **Uninstall the package:**
 
    ```bash

package/dist/agents/wizard.d.ts

@@ -21,3 +21,8 @@ export declare function pickAndInstallAgent(current: DetectedAgent[], options?:
 /** Show the uninstall picker. Runs `npm uninstall -g` for the chosen agent
  *  and returns the agent key on success, or null on cancel/failure/no candidates. */
 export declare function pickAndUninstallAgent(current: DetectedAgent[]): Promise<string | null>;
+/** Uninstall a single agent's npm package. Logs success/failure to stdout.
+ *  Shared between the `palmier agents` interactive picker and the bulk
+ *  managed-agent removal in `palmier uninstall`. */
+export declare function uninstallAgent(agent: DetectedAgent): boolean;
+export declare function uninstallManagedAgents(agents: DetectedAgent[]): void;

package/dist/agents/wizard.js

@@ -10,7 +10,7 @@ export const colors = {
     red: (s) => `\x1b[31m${s}\x1b[0m`,
     yellow: (s) => `\x1b[33m${s}\x1b[0m`,
 };
-const { bold, dim, green, cyan, red } = colors;
+const { bold, dim, green, cyan, red, yellow } = colors;
 export function printInstalledAgents(agents) {
     if (agents.length === 0) {
         console.log(`  ${dim("(none installed)")}`);
@@ -97,13 +97,23 @@ export async function pickAndUninstallAgent(current) {
     if (idx === null || idx === 0)
         return null;
     const target = uninstallable[idx - 1];
-    if (!target.npmPackage)
+    if (!uninstallAgent(target))
         return null;
-    if (!uninstallAgentPackage(target.npmPackage))
-        return null;
-    console.log(green(`  ${target.label} uninstalled.`));
     return target.key;
 }
+/** Uninstall a single agent's npm package. Logs success/failure to stdout.
+ *  Shared between the `palmier agents` interactive picker and the bulk
+ *  managed-agent removal in `palmier uninstall`. */
+export function uninstallAgent(agent) {
+    if (!agent.npmPackage)
+        return false;
+    if (!uninstallAgentPackage(agent.npmPackage)) {
+        console.log(red(`  Skipped ${agent.label}; uninstall it manually with npm uninstall -g ${agent.npmPackage}.`));
+        return false;
+    }
+    console.log(green(`  ${agent.label} uninstalled.`));
+    return true;
+}
 function installAgentPackage(agent) {
     console.log(`\nInstalling ${cyan(agent.npmPackage)}...\n`);
     const cmd = `npm install -g ${agent.npmPackage}`;
@@ -126,6 +136,28 @@ function installAgentPackage(agent) {
     }
     return true;
 }
+export function uninstallManagedAgents(agents) {
+    const managed = agents.filter((a) => a.version && a.npmPackage);
+    if (managed.length === 0) {
+        console.log(`\n${dim("No Palmier-managed agent CLIs to uninstall.")}`);
+        return;
+    }
+    console.log(`\n${bold(`Uninstalling ${managed.length} Palmier-managed agent ${managed.length === 1 ? "CLI" : "CLIs"}...`)}`);
+    let succeeded = 0;
+    for (let i = 0; i < managed.length; i++) {
+        const agent = managed[i];
+        console.log(`\n${dim(`[${i + 1}/${managed.length}]`)} ${agent.label}`);
+        if (uninstallAgent(agent))
+            succeeded++;
+    }
+    const failed = managed.length - succeeded;
+    if (failed === 0) {
+        console.log(`\n${green(`Uninstalled ${succeeded} agent ${succeeded === 1 ? "CLI" : "CLIs"}.`)}`);
+    }
+    else {
+        console.log(`\n${yellow(`Uninstalled ${succeeded} of ${managed.length} agent CLIs (${failed} skipped).`)}`);
+    }
+}
 function uninstallAgentPackage(npmPackage) {
     console.log(`\nUninstalling ${cyan(npmPackage)}...\n`);
     const cmd = `npm uninstall -g ${npmPackage}`;

package/dist/commands/uninstall.js

@@ -1,7 +1,20 @@
 import { getPlatform } from "../platform/index.js";
+import { loadConfig } from "../config.js";
+import { uninstallManagedAgents } from "../agents/wizard.js";
 export async function uninstallCommand() {
+    console.log("Stopping daemon and removing scheduled tasks...");
     const platform = getPlatform();
     platform.uninstallDaemon();
-    console.log("\nTo uninstall the package: npm uninstall -g palmier");
+    console.log("Daemon stopped and scheduled tasks removed.");
+    let config = null;
+    try {
+        config = loadConfig();
+    }
+    catch { /* host not initialized */ }
+    if (config?.agents) {
+        uninstallManagedAgents(config.agents);
+    }
+    console.log("\nUninstall finished.");
+    console.log("To remove the palmier package itself: npm uninstall -g palmier");
     console.log("To also remove configuration and task data, see https://github.com/caihongxu/palmier#uninstalling");
 }

package/package.json

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