Skip to content

Version 1 Release!

Latest

Choose a tag to compare

@5PK 5PK released this 25 Aug 14:19
· 5 commits to main since this release
9a71c68

Agility CLI v1.0.0

The Agility CLI is out of beta. Install it from npm:

npm install -g @agility/cli

Sync: instance-to-instance migration in one command

The headline of 1.0 is sync — a direct, repeatable migration from a source instance to a target instance:

agility sync --sourceGuid="abc123" --targetGuid="def456"
  • Syncs everything: content models, component models, containers, page templates, pages, content items, galleries, media assets, image focal points, and URL redirections.
  • Dependency-aware: linked content, asset references, and template references are remapped so everything points at the right entities on the target.
  • Re-runnable: reference mappings track the source-target relationship, so subsequent syncs push only what changed and skip the rest.
  • Forward-only and safe: the sync never deletes or unpublishes anything on the target.
  • Conflict handling: if an item changed on both sides, it's flagged and skipped by default; pass --overwrite=true to let the source win.
  • Publish state: synced content lands in staging by default; add --autoPublish to publish items that were published on the source.
  • Preflight: run with --preflight to see exactly what would sync — including conflicts — before writing anything.
  • Selective sync: scope a run with --elements, --models, or --models-with-deps.
  • CI/CD ready: authenticate non-interactively with a Personal Access Token via --token and --headless=true.

Full documentation: https://agilitycms.com/docs/developers/cli