unsnooze 1.4.0 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 1.5.0 — 2026-07-12
+
+- **`unsnooze update`**: one command to update unsnooze itself — runs
+  `npm install -g unsnooze@latest` and immediately prints the new version's
+  changelog. Update notices and the daemon toast now say `run: unsnooze
+  update` instead of the raw npm command.
+
 ## 1.4.0 — 2026-07-12
 
 - **Update notices**: unsnooze now checks the npm registry (at most once a

package/README.md

@@ -133,6 +133,7 @@ unsnooze message <id> "text"    # per-session wake message (--clear to reset)
 unsnooze config list            # settings (see below)
 unsnooze config set <k> <v>     # e.g. autoResume off
 unsnooze logs [-f]              # what unsnooze has been doing
+unsnooze update                 # update unsnooze itself
 unsnooze daemon                 # persistent GUI-session watcher (usually run
                                 # by launchd/systemd via `install --daemon`)
 unsnooze report [agent]         # capture a pane to report an undetected banner
@@ -226,7 +227,7 @@ verifies the limit actually lifted. It replaces the 4am alarm, not the limit.
 
 ### How do I update, and how do I know when to?
 
-`npm i -g unsnooze`. unsnooze checks the npm registry at most once a day and
+`unsnooze update` (or `npm i -g unsnooze`). unsnooze checks the npm registry at most once a day and
 tells you when a newer version exists (a line after CLI commands, plus one
 desktop notification per version); after updating, the next command shows a
 short "what's new" from the changelog. It's a plain registry GET with nothing

package/bin/unsnooze.js

@@ -82,6 +82,10 @@ async function main() {
       const { runResumer } = await import('../src/resumer.js');
       return runResumer();
     }
+    case 'update': {
+      const { runSelfUpdate } = await import('../src/update-check.js');
+      return runSelfUpdate();
+    }
     case '_update-check': {
       const { runUpdateCheck } = await import('../src/update-check.js');
       return runUpdateCheck();
@@ -116,6 +120,7 @@ Usage:
   unsnooze cancel [id|--all]       stop tracking session(s)
   unsnooze message <id|--all> <t>  set a per-session wake message (--clear to reset)
   unsnooze logs [-f]               show (or follow) the unsnooze log
+  unsnooze update                  update unsnooze itself to the latest version
   unsnooze daemon                  persistent watcher for GUI sessions (VS Code
                                    extension, desktop apps) — no tmux needed to
                                    detect; revival still opens in tmux

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unsnooze",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Auto-resume Claude Code, Codex CLI & Grok sessions in tmux when the usage limit (5-hour or weekly) resets. Wakes every limit-stopped AI coding session automatically.",
   "keywords": [
     "claude",

package/src/update-check.js

@@ -8,6 +8,7 @@
 // The check is a plain GET to registry.npmjs.org — nothing identifying.
 
 import { readFileSync, writeFileSync, renameSync, mkdirSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { getConfig } from './settings.js';
@@ -75,7 +76,7 @@ export function updateNotice(pkgVersion = PKG_VERSION) {
   if (!getConfig('updateCheck')) return null;
   const { latest } = readCache();
   if (!latest || !isNewer(latest, pkgVersion)) return null;
-  return `unsnooze ${latest} is available (you have ${pkgVersion}) — npm i -g unsnooze · ${RELEASES_URL}`;
+  return `unsnooze ${latest} is available (you have ${pkgVersion}) — run: unsnooze update · ${RELEASES_URL}`;
 }
 
 // The "## <version>" block from the CHANGELOG.md that ships in the tarball.
@@ -113,8 +114,35 @@ export async function runUpdateCheck({ fetcher, notifier = notify, now = Date.no
   if (!latest) return 0;
   const cache = writeCache({ lastCheckedAt: now, latest });
   if (isNewer(latest, PKG_VERSION) && cache.notifiedVersion !== latest) {
-    notifier('unsnooze update available', `${latest} is out (you have ${PKG_VERSION}) — npm i -g unsnooze`);
+    notifier('unsnooze update available', `${latest} is out (you have ${PKG_VERSION}) — run: unsnooze update`);
     writeCache({ notifiedVersion: latest });
   }
   return 0;
 }
+
+// `unsnooze update` — self-update via npm, then show what changed. npm -g
+// overwrites this install in place, so re-reading package.json/CHANGELOG.md
+// after a successful install yields the NEW version's info.
+export function runSelfUpdate({ runner = spawnSync, print = console.log } = {}) {
+  print(`unsnooze ${PKG_VERSION} — updating via npm install -g unsnooze@latest …`);
+  const r = runner('npm', ['install', '-g', 'unsnooze@latest'], { stdio: 'inherit' });
+  if (r.error || r.status !== 0) {
+    print(`unsnooze: update failed (${r.error ? r.error.message : `npm exited ${r.status}`}).`);
+    print('unsnooze: try it manually: npm install -g unsnooze@latest');
+    print('unsnooze: (permission errors usually mean your npm prefix needs sudo or a user-writable prefix)');
+    return r.status || 1;
+  }
+  let newVersion = PKG_VERSION;
+  try {
+    newVersion = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf-8')).version;
+  } catch { /* moved install dir — the generic message below still holds */ }
+  if (newVersion === PKG_VERSION) {
+    print(`unsnooze: already up to date (${PKG_VERSION}).`);
+  } else {
+    const section = changelogSection(newVersion);
+    print(`unsnooze: updated to ${newVersion}.${section ? ` What's new:\n${section}` : ''}`);
+  }
+  // Don't repeat "what's new" on the next command.
+  writeCache({ lastRunVersion: newVersion });
+  return 0;
+}