hubfly project
hubfly project lists your projects, gives a project to another account or organization (project transfer) and shows the history of a project's transfers and moves.
Basics
<project>is a project id or name. A name that matches several projects is refused; use the id.<token>is the offer token from the transfer email (hub_project_transfer_…). You can paste the whole link instead.- Commands that print data accept
--json. With--json, previews and prompts go to stderr, so stdout is one JSON document. - Run
hubfly project helpfor the full usage text.
hubfly project list [--org <id|slug>]
hubfly project history <project> [--json]
hubfly project transfer <project> --to <email> [--rotate-credentials] [--yes --confirm-name <name>] [--json]
hubfly project transfers [list] [--json]
hubfly project transfers status <project> [--json]
hubfly project transfers show <token> [--json]
hubfly project transfers accept <token> [--personal | --org <id|slug>] [--only <transferId>...]
[--keep-member <userId|email>...] [--yes] [--json]
hubfly project transfers decline <token> [--yes]
hubfly project transfers cancel <project> [--yes] [--json]Sending, accepting and cancelling need a dashboard session
403 MOVE_SESSION_REQUIRED. The command then prints the dashboard page that finishes the step. Previews, offers, status and history work with your CLI login.Send A Project
project transfer shows what moves with the project, which credentials stop working if you lose access, and any blockers. You then type the project name, Hubfly space emails you a 6-digit code, and you enter it. In a terminal you get three tries at the code.
| Flag | What it does |
|---|---|
--to <email> | The recipient's email address. Required. |
--rotate-credentials | Revokes every project credential at the handover, not only those of people who lose access. |
--yes --confirm-name <name> | Skips the typed confirmation. --confirm-name must equal the project name. The emailed code is still read from stdin. |
terminal
Follow Transfers
| Command | What it does |
|---|---|
transfers list | Offers waiting for you and transfers you started, with their status, progress and expiry. Offers do not show tokens: those are only in the email. |
transfers status | The open or latest transfer of a project: recipient, when the owner changes, the current step, or why it failed. |
transfers show | The offer behind a token: the sender, each project with its hostnames, domains, workloads and members, and the accounts you can accept into. |
Accept Or Decline
transfers accept shows the offer, previews the destination (balance needed, hourly cost, plans billed to you and revoked credentials), asks you to confirm and accepts. The owner changes at the next full hour.
| Flag | What it does |
|---|---|
--personal | Accept into your personal account. |
--org <id|slug> | Accept into an organization. You need its owner role, or a role that can create projects and manage billing. Without --personal or --org, a terminal lets you pick. |
--only <transferId> | Accept only some projects of a bundle. Repeat it or pass a comma list; project names work too. |
--keep-member <userId|email> | Keeps a direct member's access. Everyone else is removed at the handover. |
--yes | Skips the confirmation. Required without a terminal. |
transfers decline declines every project of the offer; the sender keeps them.
terminal
Cancel A Transfer
transfers cancel cancels an open offer, or an accepted transfer whose owner change has not started. An accepted transfer can take up to a minute to roll back; check it with transfers status.
Project History
project history lists the project's transfers and region moves, newest first, with their status and who started them.
Scripting And Exit Codes
2: invalid arguments, for example a malformed token or--yeswithout--confirm-name. Nothing is sent.3: refused by Hubfly space, includingMOVE_SESSION_REQUIREDfor a CLI token.4: a conflict reported by Hubfly space, for example another transfer or move in progress.5: the preview has blockers (they are listed), or another API error.7: you cancelled, or the typed name did not match.
hubfly project transfers status web --json | jq '{status, step: .job.stepLabel, handoverAt}'Region migration
Move Cell projects with their data. Review the freeze estimate, fee and DNS plan before confirming. Use --yes --confirm-name for a noninteractive confirmation. Migration writes accept an unrestricted personal access token.
hubfly project migrate PROJECT --region TARGET --mode warm --max-freeze 10m --wait
hubfly project migrate PROJECT --region TARGET --at 2026-12-01T04:00:00Z
hubfly project migration status PROJECT --json
hubfly project migration cancel PROJECT --yes
hubfly project migration continue keep-syncing PROJECT --yes
hubfly project migration move-back PROJECT --yes --confirm-name 'Project name'
hubfly project migration dns PROJECT
hubfly project migration attestation PROJECT --migration-id MIGRATION --json
hubfly project rehome PROJECT --region TARGET --yes --confirm-name 'Project name'--at requires RFC3339 with a timezone. Warm freeze limits accept durations from 1m to 24h. --wait polls every five seconds; --timeout defaults to 30m and stops waiting without canceling the move. A failed move or a pending freeze decision returns an error. See region migration for verification, DNS and source retention.