chore: rename npm package to mex-agent

Author: theDakshJaitly

CHANGELOG.md

@@ -5,7 +5,7 @@ All notable changes to this project will be documented in this file.
 ## [0.3.5] - 2026-05-14
 
 ### Added
-- **Package rename** — the npm package is now `mex-cli`; the installed binary command remains `mex`.
+- **Package rename** — the npm package is now `mex-agent`; the installed binary command remains `mex`.
 - **Agent memory mode** — `mex setup --mode agent-memory` creates templates for persistent-agent, homelab, OpenClaw-style, and operational-memory workspaces.
 - **Heartbeat checks** — `mex heartbeat` runs lightweight scheduled health checks over optional `last_updated` frontmatter, stale context, memory cleanup metadata, and old daily memory files.
 - **Scheduled heartbeat loop** — `mex watch --interval` runs heartbeat repeatedly in the foreground while preserving the existing post-commit hook behavior for plain `mex watch`.

README.md

@@ -15,7 +15,7 @@
 
 [![CI](https://github.com/theDakshJaitly/mex/actions/workflows/ci.yml/badge.svg)](https://github.com/theDakshJaitly/mex/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![npm version](https://img.shields.io/npm/v/mex-cli.svg)](https://www.npmjs.com/package/mex-cli)
+[![npm version](https://img.shields.io/npm/v/mex-agent.svg)](https://www.npmjs.com/package/mex-agent)
 
 </div>
 
@@ -41,10 +41,10 @@ Works with any stack — JavaScript, Python, Go, Rust, and more.
 
 ## Install
 
-The npm package is named `mex-cli` (`mex` was taken on npm). The CLI command is `mex`.
+The npm package is named `mex-agent` (`mex` was taken on npm). The CLI command is `mex`.
 
 ```bash
-npx mex-cli setup
+npx mex-agent setup
 ```
 
 That's it. The setup command creates the `.mex/` scaffold, asks which AI tool you use, pre-scans your codebase, and generates a targeted prompt to populate everything. Takes about 5 minutes.
@@ -59,14 +59,14 @@ mex sync         # fix drift
 If you skip global install, everything still works via npx:
 
 ```bash
-npx mex-cli check        # drift score
-npx mex-cli sync         # fix drift
+npx mex-agent check        # drift score
+npx mex-agent sync         # fix drift
 ```
 
 You can install globally later at any time:
 
 ```bash
-npm install -g mex-cli
+npm install -g mex-agent
 ```
 
 ## Drift Detection
@@ -91,7 +91,7 @@ Scoring: starts at 100. Deducts -10 per error, -3 per warning, -1 per info.
 
 ## CLI
 
-All commands run from your **project root**. If you didn't install globally, replace `mex` with `npx mex-cli`.
+All commands run from your **project root**. If you didn't install globally, replace `mex` with `npx mex-agent`.
 
 ### Commands
 

RELEASE_NOTES.md

@@ -4,9 +4,9 @@ This release turns mex from a drift-aware scaffold CLI into a small operational
 
 The original goal of mex is still the same: keep agent context useful, navigable, and honest without dumping an entire project into the prompt. v0.3 keeps the stable v0.2 scaffold architecture, then adds the pieces that make mex work better for persistent agents, homelabs, OpenClaw-style operational workspaces, and long-running project memory.
 
-npm package: `mex-cli@0.3.5`
+npm package: `mex-agent@0.3.5`
 
-Package rename: the npm package is now `mex-cli`. The binary command remains `mex`.
+Package rename: the npm package is now `mex-agent`. The binary command remains `mex`.
 
 ## Highlights
 
@@ -23,7 +23,7 @@ Package rename: the npm package is now `mex-cli`. The binary command remains `me
 v0.3 adds a first-class agent-memory setup mode:
 
 ```bash
-npx mex-cli setup --mode agent-memory
+npx mex-agent setup --mode agent-memory
 ```
 
 This is for projects where the "codebase" is not necessarily the main thing being remembered. Examples:
@@ -251,13 +251,13 @@ Those need a bigger architecture story and are not part of this stable v0.3 rele
 Install or update:
 
 ```bash
-npm install -g mex-cli@latest
+npm install -g mex-agent@latest
 ```
 
 Or use directly:
 
 ```bash
-npx mex-cli@latest setup
+npx mex-agent@latest setup
 ```
 
 For an existing project, no scaffold reset is needed. Update the package, then run:
@@ -270,6 +270,6 @@ mex check
 For an agent-memory workspace:
 
 ```bash
-npx mex-cli@latest setup --mode agent-memory
+npx mex-agent@latest setup --mode agent-memory
 mex heartbeat
 ```

flake.nix

@@ -30,8 +30,8 @@
 
             # Ensure templates directory is included
             postInstall = ''
-              mkdir -p $out/lib/node_modules/mex-cli/templates
-              cp -r templates/* $out/lib/node_modules/mex-cli/templates/
+              mkdir -p $out/lib/node_modules/mex-agent/templates
+              cp -r templates/* $out/lib/node_modules/mex-agent/templates/
             '';
 
             meta = with pkgs.lib; {

package-lock.json

@@ -1,5 +1,5 @@
 {
-  "name": "mex-cli",
+  "name": "mex-agent",
   "version": "0.3.5",
   "description": "CLI engine for mex scaffold — drift detection, pre-analysis, and targeted sync",
   "type": "module",

package.json

@@ -534,17 +534,17 @@ if [ "$SELECTED_CLAUDE" -eq 1 ] && command -v claude &>/dev/null; then
   echo "    \"Read .mex/ROUTER.md and tell me what you know about this project.\""
   echo ""
   info "Run commands with npx (no install needed):"
-  echo "    npx mex-cli check           Drift score"
-  echo "    npx mex-cli check --quiet    One-liner"
-  echo "    npx mex-cli sync            Fix drift"
-  echo "    npx mex-cli watch           Auto-check after every commit"
+  echo "    npx mex-agent check           Drift score"
+  echo "    npx mex-agent check --quiet    One-liner"
+  echo "    npx mex-agent sync            Fix drift"
+  echo "    npx mex-agent watch           Auto-check after every commit"
   echo ""
   info "Or install globally for shorter commands:"
-  echo "    npm install -g mex-cli"
+  echo "    npm install -g mex-agent"
   echo "    mex check / mex sync / mex watch"
   echo ""
   info "Or add to your package.json scripts:"
-  echo "    npm install --save-dev mex-cli"
+  echo "    npm install --save-dev mex-agent"
   echo ""
   echo "    \"scripts\": {"
   echo "      \"mex\": \"mex check\","
@@ -584,17 +584,17 @@ else
   echo "    \"Read .mex/ROUTER.md and tell me what you know about this project.\""
   echo ""
   info "Run commands with npx (no install needed):"
-  echo "    npx mex-cli check           Drift score"
-  echo "    npx mex-cli check --quiet    One-liner"
-  echo "    npx mex-cli sync            Fix drift"
-  echo "    npx mex-cli watch           Auto-check after every commit"
+  echo "    npx mex-agent check           Drift score"
+  echo "    npx mex-agent check --quiet    One-liner"
+  echo "    npx mex-agent sync            Fix drift"
+  echo "    npx mex-agent watch           Auto-check after every commit"
   echo ""
   info "Or install globally for shorter commands:"
-  echo "    npm install -g mex-cli"
+  echo "    npm install -g mex-agent"
   echo "    mex check / mex sync / mex watch"
   echo ""
   info "Or add to your package.json scripts:"
-  echo "    npm install --save-dev mex-cli"
+  echo "    npm install --save-dev mex-agent"
   echo ""
   echo "    \"scripts\": {"
   echo "      \"mex\": \"mex check\","

setup.sh

@@ -295,7 +295,7 @@ program
     console.log("  mex watch --interval   Run heartbeat every 30 minutes (or config value)");
     console.log("  mex watch --uninstall  Remove the post-commit hook");
     console.log();
-    console.log(chalk.dim("Not installed globally? Replace 'mex' with 'npx mex-cli'."));
+    console.log(chalk.dim("Not installed globally? Replace 'mex' with 'npx mex-agent'."));
     console.log();
   });
 

src/cli.ts

@@ -117,7 +117,7 @@ export async function runSetup(opts: { dryRun?: boolean; mode?: string } = {}):
   // Verify templates directory exists (sanity check for npm package integrity)
   if (!existsSync(TEMPLATES_DIR)) {
     throw new Error(
-      `Templates directory not found at ${TEMPLATES_DIR}. The mex-cli package may be corrupted — try reinstalling.`
+      `Templates directory not found at ${TEMPLATES_DIR}. The mex-agent package may be corrupted — try reinstalling.`
     );
   }
 
@@ -465,23 +465,23 @@ async function promptGlobalInstall(): Promise<void> {
 
     if (answer === "" || answer === "y" || answer === "yes") {
       console.log();
-      info("Installing mex-cli globally...");
+      info("Installing mex-agent globally...");
       try {
-        execSync("npm install -g mex-cli", { stdio: "inherit" });
+        execSync("npm install -g mex-agent", { stdio: "inherit" });
         console.log();
         ok("Installed globally. `mex check` and `mex sync` work from anywhere now.");
         printNextSteps(true);
       } catch {
         console.log();
         warn("Global install failed. You can retry manually:");
-        console.log("    npm install -g mex-cli");
+        console.log("    npm install -g mex-agent");
         console.log();
         printNextSteps(false);
       }
     } else {
       console.log();
       info("No problem. You can always install later:");
-      console.log("    npm install -g mex-cli");
+      console.log("    npm install -g mex-agent");
       console.log();
       printNextSteps(false);
     }
@@ -505,13 +505,13 @@ function printNextSteps(globalInstalled: boolean) {
     console.log("    mex watch              Auto-check drift after every commit");
   } else {
     info("Ongoing commands (via npx):");
-    console.log("    npx mex-cli check                Drift score — are scaffold files still accurate?");
-    console.log("    npx mex-cli check --quiet        One-liner drift score");
-    console.log("    npx mex-cli sync                 Fix drift — AI updates only what's broken");
-    console.log("    npx mex-cli watch                Auto-check drift after every commit");
+    console.log("    npx mex-agent check                Drift score — are scaffold files still accurate?");
+    console.log("    npx mex-agent check --quiet        One-liner drift score");
+    console.log("    npx mex-agent sync                 Fix drift — AI updates only what's broken");
+    console.log("    npx mex-agent watch                Auto-check drift after every commit");
     console.log();
     info("Or install globally to use the shorter `mex` command:");
-    console.log("    npm install -g mex-cli");
+    console.log("    npm install -g mex-agent");
   }
   console.log();
 }