unsnooze 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 1.3.0 — 2026-07-11
+
+- **Per-session wake messages**: `unsnooze message <id|--all> "<text>"` sets a
+  custom resume message for specific tracked sessions (`--clear` reverts).
+  Precedence: per-session → per-agent (`resumeMessages.<id>`) → global
+  `resumeMessage`. Applies on both wake paths — typed into a live pane, or
+  carried in argv for `codex resume` — and sessions with a custom message
+  show a `msg: "…"` marker in `unsnooze status`.
+
 ## 1.2.0 — 2026-07-10
 
 ### GUI surfaces: VS Code extension, desktop apps

package/README.md

@@ -128,6 +128,7 @@ claude / codex / grok           # normal usage — wrapped automatically
 unsnooze status                 # tracked sessions + reset countdowns
 unsnooze resume-now [id|--all]  # don't wait for the reset time
 unsnooze cancel [id|--all]      # stop tracking a session
+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
@@ -149,7 +150,7 @@ unsnooze help                   # full command list (also -h / --help)
 | `menuAutoAnswer` | `true` | May unsnooze answer Claude's limit menu (send keys in your pane)? Off = watch-only. |
 | `notifications` | `true` | Desktop notification on limit detected / session resumed / gave up. |
 | `guiWatch` | `true` | May the daemon watch session files for GUI-surface stops (VS Code extension, desktop apps)? Needs the daemon running (`unsnooze install --daemon`). |
-| `resumeMessage` | *"Continue where you left off…"* | The message sent to wake a session. |
+| `resumeMessage` | *"Continue where you left off…"* | The message sent to wake a session. Override it for a single session with `unsnooze message <id> "…"` — visible in `unsnooze status`. |
 | `resumeMessages.claude` / `.codex` / `.grok` | `""` | Per-agent override of `resumeMessage`. Empty = use the global message; clear one with `unsnooze config set resumeMessages.claude ""`. |
 | `agents.claude` / `agents.codex` / `agents.grok` | `true` / `true` / `false` | Which CLIs are guarded. |
 

package/bin/unsnooze.js

@@ -30,6 +30,10 @@ async function main() {
       const { cmdReport } = await import('../src/report.js');
       return cmdReport(rest);
     }
+    case 'message': {
+      const { cmdMessage } = await import('../src/cli.js');
+      return cmdMessage(rest);
+    }
     case 'config': {
       const { cmdConfig } = await import('../src/cli.js');
       return cmdConfig(rest);
@@ -83,6 +87,7 @@ Usage:
   unsnooze status                  list tracked sessions + reset countdowns
   unsnooze resume-now [id|--all]   resume stopped session(s) immediately
   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 daemon                  persistent watcher for GUI sessions (VS Code
                                    extension, desktop apps) — no tmux needed to

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unsnooze",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Wakes every limit-stopped AI coding session (Claude Code, Codex CLI, Grok) in tmux the moment the usage limit resets.",
   "keywords": [
     "claude-code",

package/src/cli.js

@@ -30,16 +30,19 @@ export function cmdStatus() {
     const id = s.sessionId ? s.sessionId.slice(0, 8) : '(no id)';
     const reset = s.resetAt ? `${new Date(s.resetAt).toLocaleString()} (${fmtCountdown(s.resetAt - now)})` : '?';
     const origin = s.origin ?? (s.pane ? 'cli' : '?');
+    const msg = s.resumeMessage
+      ? ` · msg: "${s.resumeMessage.length > 44 ? s.resumeMessage.slice(0, 44) + '…' : s.resumeMessage}"`
+      : '';
     console.log(`  [${s.status.toUpperCase().padEnd(9)}] ${id}  ${(s.agent || 'claude').padEnd(6)} ${s.limitType?.padEnd(7) ?? 'unknown'} ${s.cwd}`);
-    console.log(`              pane ${s.pane ?? '-'} · via ${origin} · resets ${reset} · attempts ${s.attempts ?? 0}/${MAX_RESUME_ATTEMPTS}${s.lastError ? ` · last error: ${s.lastError}` : ''}`);
+    console.log(`              pane ${s.pane ?? '-'} · via ${origin} · resets ${reset} · attempts ${s.attempts ?? 0}/${MAX_RESUME_ATTEMPTS}${s.lastError ? ` · last error: ${s.lastError}` : ''}${msg}`);
   }
   return 0;
 }
 
-function selectKeys(state, idOrAll) {
-  const stopped = Object.values(state.sessions).filter(s => s.status === 'stopped');
-  if (idOrAll === '--all' || idOrAll === undefined) return stopped.map(s => s.key);
-  const match = stopped.filter(s => s.key.startsWith(idOrAll) || (s.sessionId || '').startsWith(idOrAll));
+function selectKeys(state, idOrAll, statuses = ['stopped']) {
+  const candidates = Object.values(state.sessions).filter(s => statuses.includes(s.status));
+  if (idOrAll === '--all' || idOrAll === undefined) return candidates.map(s => s.key);
+  const match = candidates.filter(s => s.key.startsWith(idOrAll) || (s.sessionId || '').startsWith(idOrAll));
   return match.map(s => s.key);
 }
 
@@ -82,6 +85,33 @@ export function cmdLogs(follow) {
   return 0;
 }
 
+// `unsnooze message <id|--all> <text...>` — set (or --clear) the wake message
+// for specific sessions; the resumer prefers it over the global setting.
+export function cmdMessage(rest) {
+  const [idOrAll, ...textParts] = rest;
+  const clear = textParts[0] === '--clear';
+  const text = textParts.join(' ').trim();
+  if (!idOrAll || (!clear && !text)) {
+    console.error('unsnooze message <id|--all> <text...>   (or --clear to revert to the default)');
+    return 2;
+  }
+  const state = readState();
+  // stopped OR resuming: editing the message before a retry is legitimate.
+  const keys = selectKeys(state, idOrAll, ['stopped', 'resuming']);
+  if (keys.length === 0) { console.log('unsnooze: no matching active sessions.'); return 1; }
+  updateState(s => {
+    for (const key of keys) {
+      if (!s.sessions[key]) continue;
+      if (clear) delete s.sessions[key].resumeMessage;
+      else s.sessions[key].resumeMessage = text;
+    }
+  });
+  console.log(clear
+    ? `unsnooze: cleared custom message on ${keys.length} session(s) (global default applies).`
+    : `unsnooze: ${keys.length} session(s) will wake with: "${text}"`);
+  return 0;
+}
+
 // `unsnooze config list | get <key> | set <key> <value>`
 export function cmdConfig(rest) {
   const [action, key, ...valueParts] = rest;

package/src/resumer.js

@@ -72,8 +72,10 @@ function selfCommand() {
 export async function dispatchOne(rec, { tmux = realTmux, resumeMessage, selfCmd = selfCommand() } = {}) {
   const key = rec.key;
   const agent = getAgent(rec.agent);
-  // Explicit option wins; otherwise the agent's own message (or the global).
-  resumeMessage = resumeMessage ?? resolveResumeMessage(agent.id);
+  // Wake-message precedence: per-session (`unsnooze message <id> "..."`) →
+  // explicit option → per-agent (`resumeMessages.<id>`) → global. Applies to
+  // both the live-pane sendText and the argv reopen path.
+  resumeMessage = rec.resumeMessage ?? resumeMessage ?? resolveResumeMessage(agent.id);
 
   // Live-pane path: only if the pane still exists AND the agent CLI is its
   // foreground command (pane ids get recycled — never inject into a random