@getmikie/cli 1.1.130 → 1.1.131

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,6 +98,7 @@ 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:
@@ -103,7 +111,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 +330,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.131",
   "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.131",
+    "@getmikie/linux-x64-gnu": "1.1.131",
+    "@getmikie/win32-x64": "1.1.131"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
-  },
-  "mikieReleaseNote": "mikie update works again, and Codex keeps its hook approval across updates"
+  }
 }