claude-nomad 0.41.0 → 0.43.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## [0.43.0](https://github.com/funkadelic/claude-nomad/compare/v0.42.0...v0.43.0) (2026-06-05)
+
+
+### Added
+
+* **doctor:** summary verdict and output UX improvements ([#244](https://github.com/funkadelic/claude-nomad/issues/244)) ([46a8339](https://github.com/funkadelic/claude-nomad/commit/46a83394d1ff503db8dccb5a8b0ad59190da44cb))
+* **doctor:** warn on hooks that break under symlinked dirs without --preserve-symlinks-main ([#246](https://github.com/funkadelic/claude-nomad/issues/246)) ([d9a4d20](https://github.com/funkadelic/claude-nomad/commit/d9a4d20b034920fe6fa4b1432d81fef361e6fbd2))
+
+
+### Documentation
+
+* add features overview to README and feature tour page to docs site ([#242](https://github.com/funkadelic/claude-nomad/issues/242)) ([e45d63f](https://github.com/funkadelic/claude-nomad/commit/e45d63f9d78aef5fa9a7a2b243584e96e1e17aaf))
+* **faq:** add entry for symlink-broken relative requires in hooks ([#245](https://github.com/funkadelic/claude-nomad/issues/245)) ([fa994fb](https://github.com/funkadelic/claude-nomad/commit/fa994fb9ded981f419623dba3f50cc0cd812f986))
+
+## [0.42.0](https://github.com/funkadelic/claude-nomad/compare/v0.41.0...v0.42.0) (2026-06-04)
+
+
+### Added
+
+* **pull:** add --force-remote recovery for wedged repos ([#241](https://github.com/funkadelic/claude-nomad/issues/241)) ([3425bc4](https://github.com/funkadelic/claude-nomad/commit/3425bc44e7a0c83335f5c170401619ff07ef0592))
+
+
+### Fixed
+
+* **preview:** drop /dev/null lines and key-order diff noise ([#237](https://github.com/funkadelic/claude-nomad/issues/237)) ([2a3271c](https://github.com/funkadelic/claude-nomad/commit/2a3271c637f467a07c64c4fd8c381dd042c10e9c))
+
+
+### Documentation
+
+* **faq:** add FAQ ([#240](https://github.com/funkadelic/claude-nomad/issues/240)) ([9150c97](https://github.com/funkadelic/claude-nomad/commit/9150c97a4f760dbb7ca3fd5a59657a3f34838aac))
+* **faq:** add FAQ page with push-then-pull order of operations ([#239](https://github.com/funkadelic/claude-nomad/issues/239)) ([a0198ac](https://github.com/funkadelic/claude-nomad/commit/a0198ac1b77b87bbeef4f2dd3d11678ed58cb376))
+
 ## [0.41.0](https://github.com/funkadelic/claude-nomad/compare/v0.40.0...v0.41.0) (2026-06-03)
 
 

package/README.md

@@ -21,6 +21,30 @@ survives different file paths and your secrets never ride along.
 
 **Full documentation: <https://funkadelic.github.io/claude-nomad/>**
 
+## Features
+
+- **Sessions follow you across machines.** Start a conversation on your desktop, run
+  `claude --resume` on your laptop, and it is there. claude-nomad rewrites the machine-specific file
+  paths Claude Code embeds in every transcript, so history survives projects living at different
+  paths on different hosts.
+- **One shared setup, per-machine exceptions.** Agents, skills, slash commands, rules, hooks, and
+  your `CLAUDE.md` live in one place and follow you everywhere. Settings merge a shared base with a
+  per-host override, so one machine can run a different model or MCP URL without forking the rest.
+- **Every push is secret-scanned.** Only an explicit allow-list of paths ever leaves the machine,
+  credentials never sync, and gitleaks scans the exact files about to be published. The push aborts
+  on any hit, with an interactive menu to redact, allow, or drop the finding.
+- **Preview before you trust it.** `nomad diff` shows offline what a pull would change, and
+  `--dry-run` on pull and push prints the plan without writing anything.
+- **One command tells you what is wrong.** `nomad doctor` is a read-only health check: wedged sync
+  repo, broken hook references, hooks that would crash on session start because of a missing
+  `--preserve-symlinks-main` flag, version drift, oversized backup cache, each with a fix hint.
+- **Self-healing sync.** Every overwrite is backed up first, and `nomad pull --force-remote`
+  recovers a sync repo stuck mid-rebase while parking your stranded work on a branch, refusing
+  entirely if shared config is at risk.
+
+See the [full feature tour](https://funkadelic.github.io/claude-nomad/features/) for the rest:
+opt-in per-project sync, transcript redaction, backup pruning, and more.
+
 ## Quickstart
 
 **First host** (once, ever):
@@ -77,6 +101,12 @@ All allow paths always re-scan after writing the allowlist; a surviving finding
 push. See [Recovery flows](https://funkadelic.github.io/claude-nomad/recovery/) for the full
 decision tree.
 
+If a previous `nomad pull` left the sync repo stuck mid-rebase or mid-merge, run
+`nomad pull --force-remote` to auto-recover. It aborts the in-progress operation, parks stranded
+commits on a `nomad/stranded-<ts>` branch, and resets to `origin/main`, then re-pulls. It refuses if
+any stranded or dirty tracked changes touch synced config (shared/, hosts/, path-map.json), so
+config you care about is never silently discarded.
+
 ## Requirements
 
 - Node.js 22.22.1 or newer (24 LTS recommended)
@@ -96,5 +126,7 @@ version-staleness check and `nomad doctor --check-schema`. The CLI works without
 - [Commands reference](https://funkadelic.github.io/claude-nomad/commands/) -- all CLI flags
 - [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
+  push/pull order when both sides have changes
 - [Contributing](https://funkadelic.github.io/claude-nomad/contributing/)
 - [Security policy](https://funkadelic.github.io/claude-nomad/security/)