Update, pin, and rollback
Update, pin, and rollback
Section titled “Update, pin, and rollback”CLI application updates and content-pack updates are separate. The commands on this page update instructions, skills, subagents, and release notes. They do not update the CLI executable. To upgrade the CLI, rerun the public installer.
Agents Pack preserves your explicit component selection. New optional or recommended components become available but are not silently installed. User-owned canonical content is not part of the official update and is preserved during rollback.
Check for a new official pack
Section titled “Check for a new official pack”agents-pack update --checkThe check downloads and validates the registry’s current candidate, then reports installed and candidate versions, whether an update is available, current pin state, and candidate release notes. It does not cache or apply the candidate.
--check cannot be combined with --yes or --dry-run.
Preview and apply an update
Section titled “Preview and apply an update”agents-pack update --dry-runInteractively:
agents-pack updateNon-interactively:
agents-pack update --yesUpdate from a local candidate
Section titled “Update from a local candidate”For an installation initialized from a local pack:
agents-pack update --check --pack /path/to/new-local-packagents-pack update --pack /path/to/new-local-pack --dry-runagents-pack update --pack /path/to/new-local-pack --yesOfficial installations use the registry by default. Local installations require --pack.
Pin and unpin
Section titled “Pin and unpin”Keep the current version:
agents-pack pinA pinned installation can still check for updates, install available components, and remove optional components. Applying a different pack version stops until you unpin:
agents-pack unpinpin and unpin take effect immediately and do not accept --yes or --dry-run. Both are idempotent and still validate that managed outputs are clean.
Roll back
Section titled “Roll back”Rollback only uses previously cached packs with the same pack ID. It never downloads a missing historical version.
Newest cached older version
Section titled “Newest cached older version”agents-pack rollback --dry-runagents-pack rollback --yesWithout a version argument, Agents Pack chooses the newest cached version older than the installed version.
Exact cached version
Section titled “Exact cached version”agents-pack rollback 0.24.0 --dry-runagents-pack rollback 0.24.0 --yesA successful rollback automatically pins the restored version so a later update does not immediately undo your decision. Run agents-pack unpin when you are ready to move forward again.