agb migrate
Move an npm-global or checkout install onto the native agy plugin, or roll it back.
agb migrate moves an existing npm-global or source-checkout installation onto the native antigravity-booster agy plugin, and can roll that move back. Migration is resumable: re-running it continues from the recorded state.
Synopsis
agb migrate [--rollback]Move an npm-global/checkout install onto the native agy plugin, or roll it back.
| Flag | Argument | Description |
|---|---|---|
| --break-lock | — | — |
| --finish-uninstall | — | — |
| --force | — | re-run after MIGRATED |
| --force-rollback | — | — |
| --rollback | — | — |
Modes
| Invocation | Effect |
|---|---|
agb migrate | Run or resume the migration. |
agb migrate --force | Re-run after the state is already MIGRATED. |
agb migrate --rollback | Roll the migration back. |
agb migrate --force-rollback | Roll back even when the recorded state would refuse. |
agb migrate --break-lock | Break a stale migration lock after an interactive confirmation (refused when stdin is not a TTY); --force skips the confirmation. |
Evidence: C15 (the COMMANDS entry), migrate dispatch.
An internal --finish-uninstall mode (with --token, --uninstaller-dir, --agy-bin, --baseline) is used by the detached uninstaller during rollback and is not meant to be run by hand (finish-uninstall).
The state machine (SNAPSHOT_CREATED, SYMLINKS_RECORDED, PLUGINS_STAGED, MIGRATED, rollback states) is described in Upgrading from npm and Plugin and migration.