claude-nomad 0.56.1 → 0.57.0

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## [0.57.0](https://github.com/funkadelic/claude-nomad/compare/v0.56.2...v0.57.0) (2026-07-03)
+
+
+### Added
+
+* **docs-site:** add starlight-llms-txt plugin ([#378](https://github.com/funkadelic/claude-nomad/issues/378)) ([0604327](https://github.com/funkadelic/claude-nomad/commit/0604327ffa69abbee0b70183a49416ec14a3306c))
+* **sync:** add unified nomad sync command ([#380](https://github.com/funkadelic/claude-nomad/issues/380)) ([e60a05e](https://github.com/funkadelic/claude-nomad/commit/e60a05e62179751652d70e54ba3deb8b6b7c4859))
+
+
+### Fixed
+
+* **plugin:** tolerate a user-supplied --dry-run in push and sync wrappers ([#381](https://github.com/funkadelic/claude-nomad/issues/381)) ([7ce0a99](https://github.com/funkadelic/claude-nomad/commit/7ce0a99ae53cd8737b5e03bb0f5f730447b1108d))
+
+
+### Changed
+
+* remove vestigial private-repo guards from workflows ([#383](https://github.com/funkadelic/claude-nomad/issues/383)) ([31e52b8](https://github.com/funkadelic/claude-nomad/commit/31e52b834ca55204dac29fcec6ceee35605f818b))
+* scrub internal planning IDs from source and test comments ([#382](https://github.com/funkadelic/claude-nomad/issues/382)) ([b024b7b](https://github.com/funkadelic/claude-nomad/commit/b024b7b1b877af347db7ca1754751ede73b5879f))
+
+## [0.56.2](https://github.com/funkadelic/claude-nomad/compare/v0.56.1...v0.56.2) (2026-07-01)
+
+
+### Fixed
+
+* **pull:** retain unpushed local work and surface it in the preview ([#376](https://github.com/funkadelic/claude-nomad/issues/376)) ([3f70019](https://github.com/funkadelic/claude-nomad/commit/3f70019c89ccd77726e6330d9623e106bb9ff69c))
+
+  What this means: `nomad pull` no longer discards work you have not pushed
+  yet. Chat sessions, subagent history, and memory files that exist only on
+  this machine now survive a pull, and a synced file you have edited locally
+  (a project's `.planning` notes or its `CLAUDE.md`) is kept instead of being
+  overwritten when it differs from the incoming copy, with a note to push and
+  reconcile. `nomad diff` and `pull --dry-run` now show the count of retained
+  local-only items and the keep-local warning, where before they reported
+  `clean` / `0 collisions`.
+
 ## [0.56.1](https://github.com/funkadelic/claude-nomad/compare/v0.56.0...v0.56.1) (2026-06-30)
 
 

package/README.md

@@ -13,8 +13,9 @@
 
 Open Claude Code on a second machine and it is a blank slate: none of your custom skills, slash
 commands, tuned settings, or past conversations. **claude-nomad** keeps all of it in sync through a
-private Git repo you control. `nomad push` on one machine, `nomad pull` on the next, and everything
-is there, conversations included.
+private Git repo you control. Run `nomad sync` on any machine and everything is there, conversations
+included; it pulls in your latest config first, then publishes your local changes, so you never have
+to remember which one to run first.
 
 Not dotfiles, not rsync. **claude-nomad** understands Claude Code's state, so your session history
 survives different file paths and your secrets never ride along.
@@ -117,14 +118,19 @@ Everyday loop on any host:
 
 ```bash
 $ nomad doctor   # confirm setup
-$ nomad pull     # apply config to ~/.claude/
-$ nomad push     # publish local changes (sessions, settings)
+$ nomad sync     # pull config, then publish local changes, in one step
 ```
 
-Pull before you push whenever both machines may have changed. Sync is last-write-wins, so pushing
-stale local state over newer remote state silently overwrites it. The
-[FAQ](https://funkadelic.github.io/claude-nomad/faq/) covers the full push/pull order when both
-sides have changed.
+`nomad sync` is the command to reach for day to day: it always pulls first (so changes from your
+other machines land before anything is pushed, and work that exists only on this machine is kept,
+not deleted) and then pushes, under one lock, so there is no ordering to remember. `nomad pull` and
+`nomad push` are still available as lower-level commands for cases `sync` does not cover: recovering
+a wedged repo with `nomad pull --force-remote`, or resolving a detected secret without the
+interactive menu via `nomad push --redact-all` / `--allow` / `--allow-all` (see
+[Changing settings](#changing-settings) and
+[Recovery flows](https://funkadelic.github.io/claude-nomad/recovery/)). The
+[FAQ](https://funkadelic.github.io/claude-nomad/faq/) covers what `sync` does under the hood and the
+push/pull order it enforces.
 
 ### Make your sessions follow you
 
@@ -216,10 +222,10 @@ first (minimum version `>= 0.35.0`), then add the plugin.
 /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. The plugin versions independently from the CLI,
-but requires nomad `>= 0.35.0` because it calls recent subcommands (`nomad diff`,
-`nomad clean --backups`) and reads the doctor command's status output. See the
+It adds `/nomad:sync` (preview only), `/nomad:pull`, `/nomad:diff`, `/nomad:push` (preview only),
+`/nomad:doctor`, and `/nomad:clean`, plus a session-start drift check. The plugin versions
+independently from the CLI, but requires nomad `>= 0.35.0` because it calls recent subcommands
+(`nomad diff`, `nomad clean --backups`) and reads the doctor command's status output. See the
 [plugin guide](https://funkadelic.github.io/claude-nomad/plugin/) for details.
 
 ## Requirements