@getmikie/cli 1.1.130 → 1.1.132

package/README.md

@@ -1,58 +1,38 @@
 # Mikie
 
-This package is a thin launcher for Mikie's compiled native relay.
+Mikie gives Claude Code and Codex only the code each request needs, and keeps a
+receipt of what every request used and saved.
 
-```sh
-npx --yes --ignore-scripts --registry=https://registry.npmjs.org @getmikie/cli@1.1.108 mcp
-```
-
-For a persistent command path on Windows PowerShell:
-
-```powershell
-npm.cmd install --global @getmikie/cli@1.1.108 --registry=https://registry.npmjs.org
-```
-
-Mikie does not change your PowerShell execution policy. Keep the exact package
-name in the command: without naming the package as the install target, npm
-incorrectly targets the current directory.
+## Quickstart
 
-For a persistent command path on macOS or Linux:
+You need Node.js 22 or newer on macOS (Apple Silicon), Linux x64 or Windows x64.
 
 ```sh
-npm install --global @getmikie/cli@1.1.108 --registry=https://registry.npmjs.org
+npm install -g @getmikie/cli@latest
+mikie login
+mikie setup codex      # or: mikie setup claude
+mikie doctor
 ```
 
-Keep `--global`: Mikie is a command-line tool, not a project dependency.
-The package has no npm install script, so there is nothing to allow; the
-first `mikie` command finishes setting up the runtime and client hooks.
-These commands pin the public npm registry.
-The public OS installers additionally authenticate exact wrapper
-and native tarball bytes, install them offline, and explicitly run only Mikie's
-authenticated reconciliation script.
+Then open Codex or Claude Code in your project folder and work as usual. Mikie
+connects that project automatically.
 
-Then run:
+On Windows, if PowerShell says running scripts is disabled, install with
+`npm.cmd install -g @getmikie/cli@latest` instead.
+
+## Everyday commands
 
 ```sh
-mikie mcp
+mikie savings history    # see what Mikie has saved you
+mikie mode codex shadow  # try Mikie beside Codex without changing what it reads
+mikie privacy review     # see what Mikie can read in your project
+mikie update             # update Mikie
+mikie --help             # every command
 ```
 
-The launcher contains no relay, pricing, receipt, or model logic. npm installs
-the matching `@getmikie/*` optional platform package and the launcher executes that
-binary with inherited stdio.
-
-## Mikie Control
-
-Run one immutable, repository-scoped request through the verified Codex App
-Server runtime:
+## Other MCP clients
 
-```sh
-mikie control run --request C:\absolute\path\control-request.json --json
-```
+Any MCP client that can launch a stdio server can run Mikie with `mikie mcp`.
+Mikie ships tested setup for Claude Code and Codex only.
 
-The request must be an existing absolute JSON file. Mikie validates the frozen
-repository, allowed paths, exact model and reasoning effort, bounded model-turn
-timeout, and private temporary root before execution. The verifier argv is
-restricted to `git diff --check`; interpreters, build tools, and test runners
-that could execute repository-controlled code are rejected. The JSON result is
-content-free: it reports terminal status and hashes, never prompts, context,
-patch bodies, verifier output, or credentials.
+Docs: https://getmikie.com/docs

package/bin/mikie.mjs

@@ -44,18 +44,25 @@ import {
 
 const require = createRequire(import.meta.url);
 
-/** One next step for the update failures a customer can act on. */
-function updateGuidance(message) {
-  if (/EBUSY|EPERM|resource busy|operation not permitted|locked/i.test(message)) {
-    return "; a running Mikie process holds a file: close Codex and Claude Code, then run `mikie update` again";
+/**
+ * A failed update, worded like `claude update`: what failed, then one next
+ * step. The failure detail stays on the first line for support.
+ */
+function updateFailureLines(message, recovery) {
+  if (/another Mikie update transaction is active/.test(message)) {
+    return ["Another Mikie update is currently running. Please try again in a moment."];
   }
   if (/registry did not resolve|registry/i.test(message)) {
-    return "; the npm registry could not be reached or returned no compatible version: check the connection and run `mikie update` again";
+    return ["Failed to check for updates", "Check your internet connection, then run mikie update again"];
   }
-  if (/another Mikie update transaction is active/.test(message)) {
-    return "; wait for the other `mikie update` to finish";
+  const failed = `Error: Failed to install update: ${message}`;
+  if (/EBUSY|EPERM|resource busy|operation not permitted|locked/i.test(message)) {
+    return [failed, "Close Codex and Claude Code, then run mikie update again"];
   }
-  return "";
+  if (typeof recovery === "string" && recovery !== "mikie update") {
+    return [failed, `Run mikie update again, or reinstall with: ${recovery}`];
+  }
+  return [failed, "Run mikie update again"];
 }
 const packageMetadata = require("../package.json");
 const arguments_ = process.argv.slice(2);
@@ -91,11 +98,13 @@ Get started:
   mikie login                Sign in
   mikie setup codex          Add Mikie to Codex
   mikie setup claude         Add Mikie to Claude Code
+  mikie agent status         Mikie's instructions for Claude Code (enable or disable)
   Then open Codex or Claude Code in your project folder; Mikie connects it.
 
 Everyday:
   mikie doctor               Check that Mikie is working (--json for details)
-  mikie savings history      See what Mikie has saved you
+  mikie usage                Your usage, and what Mikie saved, since you installed it
+  mikie savings history      Estimate what Mikie would have saved on your past work
   mikie mode codex           Show or switch Mikie's Codex mode (active or shadow)
   mikie privacy review       See what Mikie can read in your project
   mikie update               Update Mikie
@@ -103,7 +112,8 @@ Everyday:
 Account:
   mikie logout               Sign out
   mikie device revoke        Remove this computer from your account
-  mikie uninstall            Remove Mikie
+  mikie remove codex         Take Mikie out of Codex (or: mikie remove claude)
+  mikie uninstall            Remove Mikie completely
 
   mikie --help               Show this help
   mikie --version            Show the installed version`);
@@ -321,16 +331,13 @@ Account:
       files,
     });
     if (result.status === "updated") {
-      console.log(`Updated Mikie to ${result.version}.`);
-      for (const setting of result.foreignSettings) {
-        console.log(`Preserved foreign setting: ${setting}`);
-      }
+      console.log(`Successfully updated from ${result.previousVersion} to version ${result.version}`);
     } else if (result.status === "reconciled") {
-      console.log(`Reconciled Mikie ${result.version} client launchers.`);
+      console.log(`Mikie is up to date (${result.version})`);
     }
   } catch (error) {
     const message = error instanceof Error ? error.message : "Mikie update failed";
-    console.error(`mikie: ${message}${updateGuidance(message)}`);
+    for (const line of updateFailureLines(message, error?.recovery)) console.error(line);
     process.exitCode = 1;
   }
 } else {

package/lib/update.mjs

@@ -845,9 +845,8 @@ export async function runUpdateTransaction({
   try {
     lease = await files.beginTransaction?.();
   } catch (error) {
-    output.writeLine(`Recovery: ${recovery}`);
     const reason = error instanceof Error ? error.message : "update recovery failed";
-    throw new Error(`${reason}. Recovery: ${recovery}`);
+    throw Object.assign(new Error(reason), { recovery });
   }
   try {
     const installedCurrentVersion = await files.currentInstalledVersion();
@@ -855,6 +854,9 @@ export async function runUpdateTransaction({
       throw new Error("installed Mikie package version is not exact");
     }
     recovery = recoveryCommand(installedCurrentVersion);
+    // Worded like `claude update`, line for line.
+    output.writeLine(`Current version: ${installedCurrentVersion}`);
+    output.writeLine("Checking for updates to latest version...");
     const resolved = await registry.resolveExactCompatibleVersion({
       packageName: WRAPPER_PACKAGE,
       currentVersion: installedCurrentVersion,
@@ -874,9 +876,15 @@ export async function runUpdateTransaction({
     const reconcileCurrentInstallation =
       versionOrder === 0 && files.requiresFinalLauncherSettlement?.() === true;
     if (versionOrder === 0 && !reconcileCurrentInstallation) {
-      output.writeLine(`Mikie is already current at ${installedCurrentVersion}.`);
+      output.writeLine(`Mikie is up to date (${installedCurrentVersion})`);
       return { status: "current", version: installedCurrentVersion };
     }
+    if (!reconcileCurrentInstallation) {
+      output.writeLine(
+        `New version available: ${resolved.version} (current: ${installedCurrentVersion})`,
+      );
+      output.writeLine("Installing update...");
+    }
 
     const snapshotRequest = { platformPackage };
     if (lease !== undefined) snapshotRequest.lease = lease;
@@ -921,7 +929,6 @@ export async function runUpdateTransaction({
       // journal. The installed entrypoint loads it before resolving a runtime;
       // its internal Node/bootstrap payload is not a customer-facing command.
       recovery = "mikie update";
-      output.writeLine(`Recovery: ${recovery}`);
       await files.markProviderPreparing(snapshot);
       providerPrepared = true;
 
@@ -1013,6 +1020,7 @@ export async function runUpdateTransaction({
       return {
         status: reconcileCurrentInstallation ? "reconciled" : "updated",
         version: resolved.version,
+        previousVersion: installedCurrentVersion,
         providerState: repairResult.receipt.after,
         adapterAction: repairResult.skipped
           ? "skipped"
@@ -1057,14 +1065,16 @@ export async function runUpdateTransaction({
           restoreFailure = restoreError;
         }
       }
-      output.writeLine(`Recovery: ${recovery}`);
       const reason = error instanceof Error ? error.message : "update transaction failed";
       if (restoreFailure) {
         const restoreReason =
           restoreFailure instanceof Error ? restoreFailure.message : "snapshot restore failed";
-        throw new Error(`${reason}; rollback failed: ${restoreReason}. Recovery: ${recovery}`);
+        throw Object.assign(
+          new Error(`${reason}; restoring the previous version failed: ${restoreReason}`),
+          { recovery },
+        );
       }
-      throw new Error(`${reason}. Recovery: ${recovery}`);
+      throw Object.assign(new Error(reason), { recovery });
     }
   } finally {
     await files.endTransaction?.(lease);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getmikie/cli",
-  "version": "1.1.130",
+  "version": "1.1.132",
   "description": "Native Mikie relay launcher for MCP clients",
   "license": "Apache-2.0",
   "repository": {
@@ -21,13 +21,12 @@
     "node": ">=22"
   },
   "optionalDependencies": {
-    "@getmikie/darwin-arm64": "1.1.130",
-    "@getmikie/linux-x64-gnu": "1.1.130",
-    "@getmikie/win32-x64": "1.1.130"
+    "@getmikie/darwin-arm64": "1.1.132",
+    "@getmikie/linux-x64-gnu": "1.1.132",
+    "@getmikie/win32-x64": "1.1.132"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
-  },
-  "mikieReleaseNote": "mikie update works again, and Codex keeps its hook approval across updates"
+  }
 }