Move
Command reference: move.
Generated from the CLI catalog at fd47c2b.
move
Move a running unit to another host.
airship move <target> --to HOST|auto [--when idle|now] [--after-blockers] [--leave ID[,ID]] [--carry auto|resume|handoff] [--model M] [--effort E] [--ctx-limit N] [--rename NEW] [--note TEXT] [--strict] [--detach]Effects: write. Agent safe: yes. Scope: controller.
Exits: 0, 1, 2, 3, 4, 5, 6, 7, 9, 10, 11, 12, 13.
--host: unsupported. --dry-run: accepted.
Related JSON schema: airship schema move-result.
| Argument | Meaning |
|---|---|
target | [host:]name, or a pane ([host:]server:%pane) |
--to | destination host, or auto |
--when | idle: wait for the next idle point; now: interrupt |
--after-blockers | wait for declared blockers instead of failing |
--leave | turn these leavable fails into warns |
--carry | session strategy |
--model | model on the destination |
--effort | effort on the destination |
--ctx-limit | ctx limit on the destination |
--rename | destination name when taken |
--note | added to the resume prompt |
--strict | every warn becomes a fail |
--detach | return at once with {move_id, log} |
move check
Read-only move preflight.
airship move check <target> --to HOST|auto|all [--when idle|now] [--leave ID,…] [--fresh]Effects: read. Agent safe: yes. Scope: controller.
Exits: 0, 1, 2, 4, 6, 7, 9.
--host: unsupported. --dry-run: unsupported.
JSON schema: airship schema move-report; data reference #/$defs/data_move_check.
| Argument | Meaning |
|---|---|
target | [host:]name, or a pane ([host:]server:%pane) |
--to | destination |
--when | idle or now |
--leave | turn these leavable fails into warns |
--fresh | ignore cached facts |
move ls
Active, attention and recent moves.
airship move ls [--active | --attention | --recent]Effects: read. Agent safe: yes. Scope: fanout.
Exits: 0, 1, 2, 7, 8.
--host: host id or all. --dry-run: unsupported.
JSON schema: airship schema move-show; data reference #/$defs/data_move_ls.
| Argument | Meaning |
|---|---|
--active | only active moves |
--attention | only moves that need attention |
--recent | add the last 7 days |
move show
One move: records, report, events, recovery commands.
airship move show <id>Effects: read. Agent safe: yes. Scope: local.
Exits: 0, 1, 2, 4, 7.
--host: host id. --dry-run: unsupported.
JSON schema: airship schema move-show; data reference #/$defs/data_move_show.
| Argument | Meaning |
|---|---|
id | move id |
move wait
Follow a move until terminal; exits with its terminal code.
airship move wait <id> [--timeout S]Effects: read. Agent safe: yes. Scope: local.
Exits: 0, 1, 2, 3, 4, 5, 6, 7, 10, 11, 12, 13.
--host: host id. --dry-run: unsupported.
JSON schema: airship schema move-result; data reference #/$defs/data_move_wait.
| Argument | Meaning |
|---|---|
id | move id |
--timeout | seconds (timeout exits 13) |
move resume
Continue or finish a move (idempotent).
airship move resume <id> [--take-over]Effects: write. Agent safe: yes. Scope: controller.
Exits: 0, 1, 2, 4, 7, 10, 11, 12, 13.
--host: unsupported. --dry-run: accepted.
Related JSON schema: airship schema move-result.
| Argument | Meaning |
|---|---|
id | move id |
--take-over | override a stale driver lease |
move cancel
Cancel a move before freeze.
airship move cancel <id>Effects: write. Agent safe: yes. Scope: local.
Exits: 0, 1, 2, 4, 6.
--host: host id. --dry-run: accepted.
Related JSON schema: airship schema move-result.
| Argument | Meaning |
|---|---|
id | move id |
move rollback
Roll a move back to its source.
airship move rollback <id> [--dest-down HOST] [--operator]Effects: write. Agent safe: no. Scope: local.
Exits: 0, 1, 2, 4, 6, 7, 10, 11, 13.
--host: host id. --dry-run: accepted.
Operator only: --dest-down.
Related JSON schema: airship schema move-result.
| Argument | Meaning |
|---|---|
id | move id |
--dest-down | the destination is known dead (operator only) |
--operator | confirm an operator action from an external caller |
evacuate
Move every movable unit off a host.
airship evacuate <host> [--to h1,h2|auto] [--when idle|now] [--only a,b] [--include-orchestrators] [--after-blockers] [--parallel N] [--operator]Effects: write. Agent safe: no. Scope: controller.
Exits: 0, 1, 2, 3, 4, 6, 7, 8, 11, 12.
--host: unsupported. --dry-run: accepted.
Operator only: --when=now.
Related JSON schema: airship schema move-result.
| Argument | Meaning |
|---|---|
source | host to empty |
--to | destination hosts, or auto |
--when | idle, or now (operator only) |
--only | only these units |
--include-orchestrators | also move orchestrators |
--after-blockers | wait for declared blockers instead of failing |
--parallel | moves in flight per destination |
--operator | confirm an operator action from an external caller |