migrations
Use when moving a Butterbase app between regions, checking migration progress, aborting a stuck move, reverse-rolling a completed move, or tearing down retained source replicas after a move is stable
Profile →npx skills add butterbase-ai/butterbase-skills --skill migrations --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Butterbase App Migrations (Multi-Region) Moving an app between regions is an orchestrated migration: data dumped from source, restored in dest, blobs copied, runtime brought up, then traffic flipped. Source replica is retained for safe rollback until you tear it down. Four small tools wrap the orchestration: | Tool | Purpose | |---|---| | `list_regions` | Discover what regions exist before suggesting one. | | `move_app` | Start a migration. Returns a `migration_id`. | | `move_app_status` | Read the current step + replica state of a specific migration. | | `manage_migrations` | Operational ops: `get_active`, `abort`, `reverse`, `list_source_replicas`. | | `teardown_source_replica` | Decommission the retained source replica once you're confident. | --- ## 1. The step sequence A successful move walks through 11 steps in order: ``` requested → reserving_dest → blocking_writes → dumping_data → restoring_data → copying_blobs → copying_runtime → flipping_routing → setting_up_reverse_replication → unblocking_writes → completed ``` The cutover happens at `flipping_routing`. Before that, the app is still served from the source. After that, traffic is on the destination. Terminal states: `c
- 1. The step sequence
- 2. Start a move
- 3. Recovery: pick the right escape hatch
- 4. Inspecting in-flight + retained state
- 5. Common pitfalls
- 6. What this skill does NOT cover
What does the migrations skill do?
Use when moving a Butterbase app between regions, checking migration progress, aborting a stuck move, reverse-rolling a completed move, or tearing down retained source replicas after a move is stable
How do I install it?
Run `npx skills add butterbase-ai/butterbase-skills --skill migrations --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From butterbase-ai/butterbase-skills, a repository with 532 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.