Neon CLI command: claim

The claim command creates a temporary Neon project when there is no Neon account yet. neon claimable is an alias. The CLI stores an identity assertion on the machine, writes provisioned variables to .env (or .env.local), and later opens a claim URL so a human can take the project into their organization.

If neon claim is not a command, or neon claim --help does not list create, install the latest CLI (npm i -g neon@latest) or use the HTTP flow in Claimable Neon.

Do not pass --api-key or --profile. Those are refused. neon auth and neon init need a Neon account; use this command instead when there is none.

Start in the browser at neon.com/claimable-neon, or give an agent auth.md.

neon claim create

Creates a temporary project and saves its identity assertion. Postgres is always requested. Pass --service for Data API, Managed Better Auth, or other services. If a neon.ts file is present, declared services are requested automatically.

neon claim create [options]

neon claim create --env-pull

neon claim create \
  --service data-api \
  --service auth \
  --env-pull

--env-pull is on by default. It writes provisioned vars to an existing .env, otherwise .env.local, and gitignores that file. If .env or .env.local already has a DATABASE_URL (or other Neon-managed keys), pass --file <path> or --no-env-pull.

After create, regular Neon CLI commands use the saved assertion. Explicit Neon account credentials take precedence when you pass them.

neon claim status

Shows a claimable project's lifecycle and claim status. Pass a project ID from neon claim list, or omit it to use the project linked in the current directory.

neon claim status [project-id] [options]

neon claim status

neon claim accept

Creates a claim code and opens the URL where a human signs in and takes the project. --open is on by default. --no-open prints the URL.

neon claim accept [project-id] [options]

neon claim accept --no-open

Opening the URL does not freeze access. Continuing to Neon from that URL starts the transfer and rotates DATABASE_URL before the console org picker.

neon claim list

Lists claimable projects saved on this machine.

neon claim list [options]

neon claim list

neon claim delete

Permanently deletes an unclaimed project, or drops a local record that can no longer reach the service. Pass a project ID from neon claim list, or omit it to use the linked project. Pass --yes to skip the confirmation prompt.

neon claim delete [project-id] [options]

neon claim delete --yes