claude-nomad 0.47.1 → 0.49.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.49.0](https://github.com/funkadelic/claude-nomad/compare/v0.48.0...v0.49.0) (2026-06-10)
+
+
+### Added
+
+* **plugin:** add companion Claude Code plugin ([#281](https://github.com/funkadelic/claude-nomad/issues/281)) ([af85994](https://github.com/funkadelic/claude-nomad/commit/af859940453b6f9419d26072be4b0e04aaea1e8f))
+
+## [0.48.0](https://github.com/funkadelic/claude-nomad/compare/v0.47.1...v0.48.0) (2026-06-09)
+
+
+### Added
+
+* **push:** surface changed shared config in push output ([#278](https://github.com/funkadelic/claude-nomad/issues/278)) ([4774661](https://github.com/funkadelic/claude-nomad/commit/477466138e203f861e60c72cb6522f25393b3987))
+* **update:** frame update output and report new version ([#279](https://github.com/funkadelic/claude-nomad/issues/279)) ([9342de1](https://github.com/funkadelic/claude-nomad/commit/9342de1187db1fd115cc73cb2b516a9477b67a54))
+
 ## [0.47.1](https://github.com/funkadelic/claude-nomad/compare/v0.47.0...v0.47.1) (2026-06-09)
 
 

package/README.md

@@ -111,6 +111,21 @@ commits on a `nomad/stranded-<ts>` branch, and resets to `origin/main`, then re-
 any stranded or dirty tracked changes touch synced config (shared/, hosts/, path-map.json), so
 config you care about is never silently discarded.
 
+## Claude Code plugin
+
+An optional companion plugin puts nomad one slash away inside Claude Code and warns you at session
+start when your synced setup has drifted. It is a thin layer over the CLI: install `claude-nomad`
+first, then add the plugin.
+
+```text
+/plugin marketplace add funkadelic/claude-nomad
+/plugin install nomad@claude-nomad
+```
+
+It adds `/nomad:pull`, `/nomad:diff`, `/nomad:push` (preview only), `/nomad:doctor`, and
+`/nomad:clean`, plus a session-start drift check. See the
+[plugin guide](https://funkadelic.github.io/claude-nomad/plugin/) for details.
+
 ## Requirements
 
 - Node.js 22.22.1 or newer (24 LTS recommended)
@@ -128,6 +143,8 @@ version-staleness check and `nomad doctor --check-schema`. The CLI works without
 - [Setup and migration](https://funkadelic.github.io/claude-nomad/quickstart/) -- full setup
   walkthrough, migrating an existing `~/.claude/`
 - [Commands reference](https://funkadelic.github.io/claude-nomad/commands/) -- all CLI flags
+- [Claude Code plugin](https://funkadelic.github.io/claude-nomad/plugin/) -- /nomad slash commands
+  and the session-start drift check
 - [Recovery flows](https://funkadelic.github.io/claude-nomad/recovery/) -- backups, drop-session,
   redact, gitleaks allowlist, non-interactive allow
 - [FAQ](https://funkadelic.github.io/claude-nomad/faq/) -- common questions, like the right

package/dist/nomad.mjs

@@ -1920,7 +1920,7 @@ function reportBackupsCheck(section2, backupBase2 = backupBase()) {
   if (count > DOCTOR_BACKUP_COUNT_WARN || sizeMb > DOCTOR_BACKUP_SIZE_WARN_MB) {
     addItem(
       section2,
-      `${yellow(warnGlyph)} backups: ${count} dirs / ${sizeMb.toFixed(1)} MB (run 'nomad clean --backups')`
+      `${yellow(warnGlyph)} backups: ${count} dirs / ${sizeMb.toFixed(1)} MB (run 'nomad clean --backups --keep <N>'; bare --backups only prunes dirs older than 14d)`
     );
   }
 }
@@ -4166,10 +4166,18 @@ function buildExtrasSection(items, extrasSkipped) {
   if (skip !== null) addItem(s, skip);
   return s;
 }
+function buildGlobalConfigSection(rows) {
+  const s = section("Global config");
+  for (const row2 of rows) {
+    addItem(s, `${green(okGlyph)} ${row2.label} ${row2.path}`);
+  }
+  return s;
+}
 function syncedSections(st) {
   const sessions = st.dryRun ? st.remap.wouldPush : st.remap.pushed;
   const extras = st.dryRun ? st.extras.wouldPush : st.extras.pushed;
   return [
+    buildGlobalConfigSection(st.globalConfig),
     buildSessionsSection(sessions, st.remap.unmapped),
     buildExtrasSection(extras, st.extras.skipped)
   ];
@@ -5171,6 +5179,77 @@ function enforceAllowList(statusPorcelain, map) {
   throw new NomadFatal("push allow-list violations");
 }
 
+// src/push-global-config.ts
+init_config();
+import { execFileSync as execFileSync15 } from "node:child_process";
+var STATUS_LABELS = {
+  A: "add",
+  M: "modify",
+  D: "delete",
+  R: "rename",
+  C: "copy",
+  T: "type-change",
+  U: "unmerged",
+  X: "unknown"
+};
+function labelForStatus(statusToken) {
+  const letter = statusToken[0] ?? "";
+  return STATUS_LABELS[letter] ?? "change";
+}
+function buildPrefixSets(hostname2) {
+  const exactPrefixes = /* @__PURE__ */ new Set();
+  const dirPrefixes = [];
+  for (const name of SHARED_LINKS) {
+    const p = `shared/${name}`;
+    if (name.includes(".")) {
+      exactPrefixes.add(p);
+    } else {
+      dirPrefixes.push(p);
+    }
+  }
+  exactPrefixes.add("shared/settings.base.json");
+  exactPrefixes.add(`hosts/${hostname2}.json`);
+  return { exactPrefixes, dirPrefixes };
+}
+function isInScope(filePath, exactPrefixes, dirPrefixes) {
+  if (filePath.startsWith("shared/projects/") || filePath.startsWith("shared/extras/")) {
+    return false;
+  }
+  if (exactPrefixes.has(filePath)) return true;
+  return dirPrefixes.some((prefix) => filePath.startsWith(`${prefix}/`));
+}
+function collectGlobalConfigChanges(repoHome2, hostname2, opts) {
+  const args = opts.staged ? ["diff", "--cached", "--name-status", "-z"] : ["diff", "HEAD", "--name-status", "-z"];
+  const raw = execFileSync15("git", args, {
+    cwd: repoHome2,
+    stdio: ["ignore", "pipe", "pipe"]
+  }).toString();
+  const { exactPrefixes, dirPrefixes } = buildPrefixSets(hostname2);
+  const changes = [];
+  const tokens = raw.split("\0");
+  if (tokens.at(-1) === "") tokens.pop();
+  let i = 0;
+  while (i < tokens.length) {
+    const statusToken = tokens[i++] ?? "";
+    if (statusToken === "") continue;
+    const firstLetter = statusToken[0] ?? "";
+    const isRenameOrCopy = firstLetter === "R" || firstLetter === "C";
+    if (isRenameOrCopy) {
+      i++;
+      const newPath = tokens[i++] ?? "";
+      if (isInScope(newPath, exactPrefixes, dirPrefixes)) {
+        changes.push({ status: firstLetter, label: labelForStatus(statusToken), path: newPath });
+      }
+    } else {
+      const filePath = tokens[i++] ?? "";
+      if (isInScope(filePath, exactPrefixes, dirPrefixes)) {
+        changes.push({ status: firstLetter, label: labelForStatus(statusToken), path: filePath });
+      }
+    }
+  }
+  return changes;
+}
+
 // src/commands.push.ts
 init_push_leak_verdict();
 init_push_checks();
@@ -5276,6 +5355,7 @@ function guardGitlinks(repo) {
 }
 async function commitAndPush(st, ts, map, redactAll, allowAll, allowRule, repo) {
   gitOrFatal(["add", "-A"], "git add", repo);
+  st.globalConfig = collectGlobalConfigChanges(repo, HOST, { staged: true });
   let verdict = withSpinner("Scanning for secrets", () => scanPushVerdict(repo));
   if (verdict.leak) {
     renderPushTree(st, verdict);
@@ -5285,7 +5365,8 @@ async function commitAndPush(st, ts, map, redactAll, allowAll, allowRule, repo)
   withSpinner("Pushing", () => gitOrFatal(["push"], "git push", repo));
   renderPushTree(st, verdict);
 }
-function runDryRunPreview(st, map) {
+function runDryRunPreview(st, map, repo) {
+  st.globalConfig = collectGlobalConfigChanges(repo, HOST, { staged: false });
   if (map === null) {
     renderNoScanTree(st, { noMapHint: true });
     return;
@@ -5327,7 +5408,7 @@ async function cmdPush(opts = {}) {
     const ts = freshBackupTs(backup);
     const remap = withSpinner("Syncing sessions", () => remapPush(ts, { dryRun }));
     const extras = withSpinner("Syncing extras", () => remapExtrasPush(ts, { dryRun }));
-    const st = { dryRun, remap, extras };
+    const st = { dryRun, remap, extras, globalConfig: [] };
     guardGitlinks(repo);
     const status = gitStatusPorcelainZ(repo, { untrackedAll: true });
     if (!dryRun && !status) {
@@ -5337,12 +5418,12 @@ async function cmdPush(opts = {}) {
     }
     const mapPath = join43(repo, "path-map.json");
     if (!existsSync37(mapPath)) {
-      if (dryRun) return runDryRunPreview(st, null);
+      if (dryRun) return runDryRunPreview(st, null, repo);
       die("path-map.json missing, cannot enforce push allow-list");
     }
     const map = readPathMap(mapPath);
     if (status) enforceAllowList(status, map);
-    if (dryRun) return runDryRunPreview(st, map);
+    if (dryRun) return runDryRunPreview(st, map, repo);
     await commitAndPush(st, ts, map, redactAll, allowAll, allowRule, repo);
   } catch (err) {
     if (err instanceof NomadFatal) {
@@ -5357,9 +5438,17 @@ async function cmdPush(opts = {}) {
 }
 
 // src/commands.update.ts
-import { execFileSync as execFileSync15 } from "node:child_process";
+import { execFileSync as execFileSync16 } from "node:child_process";
 init_utils();
-function cmdUpdate(run = execFileSync15) {
+function readInstalledVersion(run = execFileSync16) {
+  try {
+    return run("nomad", ["--version"], { encoding: "utf8" }).toString().trim() || null;
+  } catch {
+    return null;
+  }
+}
+function cmdUpdate(run = execFileSync16) {
+  console.log("Updating claude-nomad CLI via npm...");
   try {
     run("npm", ["update", "-g", "claude-nomad"], { stdio: "inherit" });
   } catch (err) {
@@ -5369,6 +5458,12 @@ function cmdUpdate(run = execFileSync15) {
     }
     throw new NomadFatal(`npm update -g claude-nomad failed: ${e.message}`);
   }
+  const version = readInstalledVersion(run);
+  if (version) {
+    console.log(`claude-nomad is now at v${version}`);
+  } else {
+    console.log('Update complete. Run "nomad --version" to confirm the new version.');
+  }
 }
 
 // src/nomad.ts
@@ -5406,14 +5501,14 @@ import { join as join46 } from "node:path";
 
 // src/init.gh-onboard.ts
 init_config();
-import { execFileSync as execFileSync16 } from "node:child_process";
+import { execFileSync as execFileSync17 } from "node:child_process";
 init_utils();
 var DEFAULT_REPO_NAME = "claude-nomad-config";
 function isValidRepoName(name) {
   return /^[A-Za-z0-9._-]{1,100}$/.test(name);
 }
 var GH_NETWORK_TIMEOUT_MS = 3e4;
-function ensureOriginRepo(repoName, run = execFileSync16) {
+function ensureOriginRepo(repoName, run = execFileSync17) {
   if (!isValidRepoName(repoName)) {
     die(
       `invalid repo name: ${JSON.stringify(repoName)}. Use only letters, digits, hyphens, underscores, and dots (1-100 chars).`
@@ -5864,7 +5959,7 @@ function parsePushArgs(argv) {
 // package.json
 var package_default = {
   name: "claude-nomad",
-  version: "0.47.1",
+  version: "0.49.0",
   type: "module",
   description: "Sync Claude Code config (~/.claude/) across machines via a private Git repo, with path remapping and per-host settings overrides.",
   keywords: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-nomad",
-  "version": "0.47.1",
+  "version": "0.49.0",
   "type": "module",
   "description": "Sync Claude Code config (~/.claude/) across machines via a private Git repo, with path remapping and per-host settings overrides.",
   "keywords": [