@karimsa/mdxserve 0.1.0 → 0.3.0

package/README.md

@@ -41,6 +41,11 @@ mdxserve setup      # optional: installs the writing skill for Claude Code and C
 (through `npx skills add`) and removes the MCP registration that older versions created. It is
 safe to re-run; run it again after upgrading so the installed skill matches the CLI.
 
+Interactive commands check for updates in the background at most once a day and show
+cached update notices on startup. Updates are never installed automatically. Disable
+checks with `--no-update-notifier` or `NO_UPDATE_NOTIFIER=1`. CI, noninteractive commands,
+and `--json` output stay quiet.
+
 ## Quick start
 
 ```bash

package/dist/cli.js

@@ -4852,10 +4852,27 @@ function zxCommandRunner() {
   };
 }
 
+// src/cli/updates.ts
+async function notifyAboutUpdates() {
+  if (!process.stdout.isTTY || !process.stderr.isTTY || "NO_UPDATE_NOTIFIER" in process.env || process.argv.some(
+    (argument) => ["--json", "--no-update-notifier", "--version", "-V", "--help", "-h"].includes(argument)
+  )) {
+    return;
+  }
+  try {
+    const { default: updateNotifier } = await import("update-notifier");
+    updateNotifier({
+      pkg: { name: "@karimsa/mdxserve", version: readPackageVersion() },
+      updateCheckInterval: 24 * 60 * 60 * 1e3
+    }).notify({ defer: false });
+  } catch {
+  }
+}
+
 // src/index.ts
 var program = new Command();
 var NOT_RUNNING = `mdxserve: ${NO_SERVER_MESSAGE}`;
-program.name("mdxserve").description("Serve a directory of Markdown/MDX files, like `serve` but for docs").version(readPackageVersion());
+program.name("mdxserve").option("--no-update-notifier", "disable update checks and notifications").description("Serve a directory of Markdown/MDX files, like `serve` but for docs").version(readPackageVersion());
 program.command("serve", { isDefault: true }).description(
   "Start the server; mount folders with -w (repeatable) or later with `mdxserve roots add <dir>`"
 ).option("-p, --port <n>", "port to listen on", "4040").option("--host <host>", "host to bind to (use 0.0.0.0 to expose on the LAN)", "127.0.0.1").option(
@@ -5088,4 +5105,5 @@ program.command("setup").description(
     else console.log(`${cleanup.client} not found, skipping`);
   }
 });
+await notifyAboutUpdates();
 await program.parseAsync(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@karimsa/mdxserve",
-	"version": "0.1.0",
+	"version": "0.3.0",
 	"description": "Serve a directory of Markdown/MDX files, like `serve` but for docs",
 	"license": "MIT",
 	"repository": {
@@ -16,9 +16,7 @@
 		"cli"
 	],
 	"type": "module",
-	"bin": {
-		"mdxserve": "dist/cli.js"
-	},
+	"bin": "dist/cli.js",
 	"files": [
 		"dist",
 		"client",
@@ -92,6 +90,7 @@
 		"tailwindcss": "4.3.3",
 		"tippy.js": "6.3.7",
 		"trash": "10.1.1",
+		"update-notifier": "7.3.1",
 		"vfile-message": "4.0.3",
 		"vite": "8.2.1",
 		"zod": "4.4.3",
@@ -104,6 +103,7 @@
 		"@types/react": "19.2.18",
 		"@types/react-dom": "19.2.4",
 		"@types/svg-pan-zoom": "3.4.0",
+		"@types/update-notifier": "6.0.8",
 		"@yarnpkg/types": "4.0.1",
 		"esbuild": "0.28.2",
 		"fast-check": "4.9.0",