Tool pages / Prisma CLI

Prisma CLI 7.10.0: latest version, Prisma 8 RC shift and gotchas

Latest: Prisma CLI 7.10.0, released (release notes).

Last verified 2026-10-07 against 7.10.0. Page updated . Also as Markdown and JSON.

The latest stable Prisma CLI (prisma, repo prisma/orm) is 7.10.0, released 2026-08-25 12:54 UTC. Upgrade with npm i -g prisma@7.10.0 or pin prisma@7.10.0 in package.json. On npm, dist-tags.latest currently resolves to 8.0.0-rc.21 (Prisma 8 RC), which replaces generate with contract emit and migrate dev with db migrate; projects needing Prisma 7 commands should pin prisma@7.10.0 or install @prisma/prisma7.

How do I install or upgrade to Prisma CLI 7.10.0?

Pin latest stable Prisma 7 (recommended for existing projects):

npm i -D prisma@7.10.0 @prisma/client@7.10.0
npx prisma --version   # 7.10.0

npm global install (pinned to stable Prisma 7):

npm i -g prisma@7.10.0
prisma --version

Run Prisma 7 alongside Prisma 8 using the compatibility package:

npm i -D @prisma/prisma7
npx prisma7 --version

pnpm / yarn / bun:

pnpm add -D prisma@7.10.0 @prisma/client@7.10.0
yarn add -D prisma@7.10.0 @prisma/client@7.10.0
bun add -d prisma@7.10.0 @prisma/client@7.10.0

Install Prisma 8 RC line (new unified platform CLI):

npm i -g prisma@8.0.0-rc.21
prisma --version   # 8.0.0-rc.21

Prisma CLI key facts

What changed in the last 5 Prisma CLI releases?

Prisma CLI 7.10.0 (2026-08-25 12:54 UTC)

  • Introduced @prisma/prisma7 compatibility package to retain Prisma 7 CLI and configuration alongside Prisma 8 installs. (source)
  • Prisma Studio local server security hardening: Studio binds exclusively to 127.0.0.1. (source)
  • Added global vs local CLI version mismatch warning to avoid generating incompatible Client artifacts. (source)

Prisma CLI 7.9.1 (2026-07-27 14:17 UTC)

  • Resolved security advisory in transitive dependency of Prisma CLI via @prisma/dev (issue #29780). (source)

Prisma CLI 7.9.0 (2026-07-21 07:26 UTC)

  • Added shell tab completions command (complete) covering commands, subcommands, and flags for bash, zsh, fish, and PowerShell. (source)
  • Prisma Compute integrations: long-lived serverless container hosting colocated with Prisma Postgres. (source)

Prisma CLI 7.8.0 (2026-04-22 14:19 UTC)

  • Added queryPlanCacheMaxSize option to PrismaClient constructor for fine-grained query plan cache control. (source)
  • Fixed misleading error message in prisma migrate diff referencing the removed --shadow-database-url flag. (source)
  • Fixed prisma migrate dev failure with CREATE INDEX CONCURRENTLY inside transactions on PostgreSQL. (source)

Prisma CLI 7.7.0 (2026-04-07 16:00 UTC)

  • New prisma bootstrap command sequencing interactive Prisma Postgres setup (template, link, install, migrate, generate, seed). (source)

Which Prisma CLI commands and flags were added or removed?

Prisma CLI 7.9.1 → 7.10.0

0 commands added, 0 removed; CLI definitions unchanged; added distribution identity and local version mismatch detector.

Method: from source (not run): compared packages/cli/src/bin.ts and packages/cli/src/CLI.ts across tags 7.9.1 and 7.10.0 via GitHub API. Hidden flags do not appear in help.

  • The last two stable releases. Command definitions in packages/cli/src/bin.ts remained identical across 7.9.1 and 7.10.0.
  • 7.10.0 added packages/cli/src/utils/cli-distribution-identity.ts enabling the same command tree to run under the @prisma/prisma7 package as prisma7.
  • 7.10.0 added packages/cli/src/utils/global-local-version-mismatch.ts to warn when global and local CLI versions differ.

Prisma CLI 7.9.0 → 7.9.1

0 commands added, 0 removed; patch release bumping transitive dependency @prisma/dev.

Method: from source (not run): compared repository file changes across tags 7.9.0 and 7.9.1 via GitHub API.

  • A security patch release that bumped @prisma/dev to resolve issue #29780. No CLI command, option, or behavior changed.

Prisma CLI 7.8.0 → 7.9.0

1 command added, 0 removed: complete added for shell tab completions.

Method: from source (not run): compared packages/cli/src/bin.ts across tags 7.8.0 and 7.9.0 via GitHub API.

Commands added:

  • complete
  • complete (Completions.new()) was mounted in packages/cli/src/bin.ts to output shell completion scripts for bash, zsh, fish, and PowerShell.

Prisma CLI 7.6.0 → 7.7.0

1 command added, 0 removed: bootstrap added for interactive project onboarding.

Method: from source (not run): compared packages/cli/src/bin.ts across tags 7.6.0 and 7.7.0 via GitHub API.

Commands added:

  • bootstrap
  • bootstrap (Bootstrap.new()) was mounted in packages/cli/src/bin.ts to provide a single interactive flow for starter scaffolding, linking, and schema migrations.

Prisma CLI 7.10.0 → 8.0.0-rc.21

Major architecture shift: 70 commands added (platform, compute, contracts, migrations), 16 legacy commands removed (generate, migrate dev, db push).

Method: from source (not run): compared command definitions in prisma/orm@7.10.0 packages/cli/src/bin.ts against prisma/prisma-cli@v8.0.0-rc.21 packages/cli/src/cli.ts.

Commands added:

  • auth login
  • auth logout
  • auth whoami
  • auth workspace list
  • auth workspace use
  • auth workspace logout
  • branch list
  • bucket list
  • bucket create
  • bucket delete
  • bucket key list
  • bucket key create
  • bucket key delete
  • contract emit
  • contract infer
  • contract format
  • contract print
  • db init
  • db migrate
  • db schema
  • db sign
  • db update
  • db verify
  • deploy
  • feedback
  • git connect
  • git disconnect
  • lsp
  • migration check
  • migration graph
  • migration list
  • migration log
  • migration new
  • migration plan
  • migration ref delete
  • migration ref list
  • migration ref set
  • migration show
  • migration status
  • orm init
  • project list
  • project show
  • project create
  • project link
  • project rename
  • project delete
  • project transfer
  • project env add
  • project env update
  • project env list
  • project env delete
  • service list
  • service logs
  • service create
  • service show
  • service open
  • service version list
  • service version show
  • service version promote
  • service version rollback
  • service version start
  • service version stop
  • service version delete
  • service delete
  • service domain add
  • service domain show
  • service domain delete
  • service domain retry
  • service domain wait
  • skills sync
  • skills list

Commands removed:

  • bootstrap
  • complete
  • db execute
  • db pull
  • db push
  • db seed
  • generate
  • mcp
  • migrate deploy
  • migrate dev
  • migrate diff
  • migrate reset
  • migrate resolve
  • migrate status
  • studio
  • validate
  • Prisma 8 RC replaces the standalone ORM CLI with a unified Developer Platform CLI.
  • generate is replaced by contract emit, migrate dev is replaced by db migrate and migration plan, and db push/pull are replaced by contract operations.
  • Unpinned installs hit Prisma 8 RC because npm dist-tag latest points to 8.0.0-rc.21. To stay on Prisma 7, pin prisma@7.10.0 or run via @prisma/prisma7.

What breaks when upgrading Prisma CLI, and how do I migrate?

VersionChangeMigration
8.0.0-rc.21Prisma 8 RC unified CLI retires prisma generate, prisma migrate dev, and prisma db push.In Prisma 8, use prisma contract emit instead of generate, and prisma db migrate instead of migrate dev. In existing Prisma 7 projects, pin prisma@7.10.0 in package.json or install @prisma/prisma7 and run npx prisma7 <command>.
7.10.0Prisma Studio local server binds exclusively to IPv4 loopback 127.0.0.1 and drops Accelerate URL support.Pass a direct database URL (postgresql://...) rather than a prisma:// or prisma+postgres:// proxy connection string when launching Prisma Studio.
7.0.0--shadow-database-url CLI flag was removed from prisma migrate diff in Prisma 7.Configure shadow database parameters in prisma.config.ts or project datasource configuration instead of passing --shadow-database-url on the command line.

What Prisma CLI errors did we reproduce, and how do I fix them?

Unpinned npx prisma generate fails on Prisma 8 RC with unknown command (Prisma CLI 8.0.0-rc.21)

npx prisma generate
✘ [CLI.UNKNOWN_COMMAND] unknown command "generate"
  docs: https://www.prisma.io/docs/errors#CLI.UNKNOWN_COMMAND

Fix: Because npm dist-tag latest resolves to 8.0.0-rc.21, unpinned npx prisma runs Prisma 8 where generate does not exist. Pin to Prisma 7 with npm i -D prisma@7.10.0 @prisma/client@7.10.0 and run npx prisma generate, or use npx @prisma/prisma7 generate. In Prisma 8, the equivalent is prisma contract emit. (source)

Global vs local CLI version mismatch warning (Prisma CLI 7.10.0)

prisma generate
warn The globally installed prisma@7.10.0 does not match the local package @prisma/client@7.9.1 installed in this project.
This may generate Prisma Client artifacts that are incompatible with the local runtime.
Run npx prisma generate to use the local Prisma CLI, or align your global and local Prisma versions.

Fix: Run commands via npx prisma generate so the local devDependency version is used, or update package.json to align @prisma/client and prisma to the same version. (source)

Prisma Studio refuses Accelerate proxy connection URLs (Prisma CLI 7.10.0)

npx prisma studio
Error: Prisma Studio no longer supports Accelerate URLs (`prisma://` or `prisma+postgres://`). Use a direct database connection string instead.

Fix: Provide a direct database connection string (such as postgresql://user:pass@host:5432/db) in .env or pass --url <direct-url> instead of using an Accelerate proxy string. (source)

Retired migration command path fails with CLI.COMMAND_MOVED (Prisma CLI 8.0.0-rc.21)

prisma migration apply
✘ [CLI.COMMAND_MOVED] `migration apply` has been replaced
  why: Applying a migration is a move to a target contract, not a verb of its own.
→ Use the replacement: prisma db migrate --to <contract>

Fix: Run prisma db migrate --to <contract> instead of prisma migration apply. (source)

Prisma CLI release history by month

2026-10: 8.0.0-rc.15 – 8.0.0-rc.21

  • Prisma 8 RC line iterations: v8.0.0-rc.21 published to npm dist-tag latest, ArkType 2.2 engine toolchain alignment. (source)
  • @prisma/cli-engine 0.6.3 update and contract emission error reporting improvements. (source)

2026-09: 8.0.0-rc.9 – 8.0.0-rc.14

  • Renamed Prisma Next to Prisma 8 across CLI identifiers and configuration files (v8.0.0-rc.10). (source)
  • Environment variables dropped NEXT_ infix (PRISMA_DISABLE_TELEMETRY, PRISMA_DEBUG). (source)

2026-08: 7.10.0, 8.0.0-rc.1 – 8.0.0-rc.8

  • Prisma ORM 7.10.0 stable release introducing @prisma/prisma7 compatibility package and Studio security hardening. (source)
  • Inaugural Prisma 8 RC releases (v8.0.0-rc.1) establishing unified platform CLI and contract workflows. (source)

2026-07: 7.9.0 – 7.9.1

  • Prisma ORM 7.9.0 stable release adding shell tab completions (prisma complete) and Prisma Compute. (source)
  • Prisma ORM 7.9.1 patch release addressing transitive dependency security advisory via @prisma/dev. (source)

2026-05: 7.8.0 (maintenance)

  • Initial development and repository initialization of unified @prisma/cli platform binary. (source)

2026-04: 7.7.0 – 7.8.0

  • Prisma ORM 7.8.0 adding queryPlanCacheMaxSize and shadow-database-url error fixes. (source)
  • Prisma ORM 7.7.0 adding prisma bootstrap interactive onboarding flow for Prisma Postgres. (source)

Sources

Last verified: 2026-10-07.