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=trueto let the source win. - Publish state: synced content lands in staging by default; add
--autoPublishto publish items that were published on the source. - Preflight: run with
--preflightto 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
--tokenand--headless=true.
Full documentation: https://agilitycms.com/docs/developers/cli