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).
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.0npm global install (pinned to stable Prisma 7):
npm i -g prisma@7.10.0
prisma --versionRun Prisma 7 alongside Prisma 8 using the compatibility package:
npm i -D @prisma/prisma7
npx prisma7 --versionpnpm / 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.0Install Prisma 8 RC line (new unified platform CLI):
npm i -g prisma@8.0.0-rc.21
prisma --version # 8.0.0-rc.21Prisma CLI key facts
- Latest stable release: 7.10.0 on 2026-08-25 12:54 UTC (GitHub tag 7.10.0; npm publish 12:47 UTC). Previous stable release: 7.9.1 on 2026-07-27 14:17 UTC.
- On npm, dist-tag
latestresolves to8.0.0-rc.21(published 2026-10-07 12:35 UTC) whileprevpoints to7.10.0. An unpinnednpm i -g prismaor barenpx prismainstalls the Prisma 8 RC. - Prisma 8 RC replaces classic commands:
prisma generateis replaced byprisma contract emit,prisma migrate devis replaced byprisma db migrateandprisma migration plan, andprisma db pushis replaced by contract operations. - 7.10.0 introduced
@prisma/prisma7, a compatibility package providing theprisma7binary so projects can run Prisma 7 commands alongside Prisma 8. - 7.10.0 added global vs local version mismatch detection in
packages/cli/src/utils/global-local-version-mismatch.ts, warning when a global CLI differs from the project's@prisma/client. - Prisma Studio in 7.10.0 binds exclusively to IPv4 loopback 127.0.0.1 (
STUDIO_SERVER_HOST = '127.0.0.1') and explicitly rejects Accelerate proxy URLs (prisma://andprisma+postgres://). - 21,985,428 weekly downloads on npm in the week ending 2026-10-04; 47,695 GitHub stars and Apache-2.0 licence on 2026-10-07.
What changed in the last 5 Prisma CLI releases?
Prisma CLI 7.10.0 (2026-08-25 12:54 UTC)
- Introduced
@prisma/prisma7compatibility 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)
Prisma CLI 7.8.0 (2026-04-22 14:19 UTC)
- Added
queryPlanCacheMaxSizeoption toPrismaClientconstructor for fine-grained query plan cache control. (source) - Fixed misleading error message in
prisma migrate diffreferencing the removed--shadow-database-urlflag. (source) - Fixed
prisma migrate devfailure withCREATE INDEX CONCURRENTLYinside transactions on PostgreSQL. (source)
Prisma CLI 7.7.0 (2026-04-07 16:00 UTC)
- New
prisma bootstrapcommand 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.tsremained identical across 7.9.1 and 7.10.0. - 7.10.0 added
packages/cli/src/utils/cli-distribution-identity.tsenabling the same command tree to run under the@prisma/prisma7package asprisma7. - 7.10.0 added
packages/cli/src/utils/global-local-version-mismatch.tsto 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/devto 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 inpackages/cli/src/bin.tsto 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 inpackages/cli/src/bin.tsto 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 loginauth logoutauth whoamiauth workspace listauth workspace useauth workspace logoutbranch listbucket listbucket createbucket deletebucket key listbucket key createbucket key deletecontract emitcontract infercontract formatcontract printdb initdb migratedb schemadb signdb updatedb verifydeployfeedbackgit connectgit disconnectlspmigration checkmigration graphmigration listmigration logmigration newmigration planmigration ref deletemigration ref listmigration ref setmigration showmigration statusorm initproject listproject showproject createproject linkproject renameproject deleteproject transferproject env addproject env updateproject env listproject env deleteservice listservice logsservice createservice showservice openservice version listservice version showservice version promoteservice version rollbackservice version startservice version stopservice version deleteservice deleteservice domain addservice domain showservice domain deleteservice domain retryservice domain waitskills syncskills list
Commands removed:
bootstrapcompletedb executedb pulldb pushdb seedgeneratemcpmigrate deploymigrate devmigrate diffmigrate resetmigrate resolvemigrate statusstudiovalidate
- Prisma 8 RC replaces the standalone ORM CLI with a unified Developer Platform CLI.
generateis replaced bycontract emit,migrate devis replaced bydb migrateandmigration plan, anddb push/pullare replaced by contract operations.- Unpinned installs hit Prisma 8 RC because npm dist-tag
latestpoints to8.0.0-rc.21. To stay on Prisma 7, pinprisma@7.10.0or run via@prisma/prisma7.
What breaks when upgrading Prisma CLI, and how do I migrate?
| Version | Change | Migration |
|---|---|---|
| 8.0.0-rc.21 | Prisma 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.0 | Prisma 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_COMMANDFix: 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 generatewarn 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 studioError: 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
2026-09: 8.0.0-rc.9 – 8.0.0-rc.14
2026-08: 7.10.0, 8.0.0-rc.1 – 8.0.0-rc.8
2026-07: 7.9.0 – 7.9.1
2026-05: 7.8.0 (maintenance)
- Initial development and repository initialization of unified
@prisma/cliplatform binary. (source)
2026-04: 7.7.0 – 7.8.0
Sources
- Prisma ORM 7.10.0 GitHub release notes (read 2026-10-07)
- Prisma ORM 7.9.1 GitHub release notes (read 2026-10-07)
- Prisma ORM 7.9.0 GitHub release notes (read 2026-10-07)
- Prisma ORM 7.8.0 GitHub release notes (read 2026-10-07)
- Prisma ORM 7.7.0 GitHub release notes (read 2026-10-07)
- Prisma ORM 8.0.0-rc.16 GitHub release notes (read 2026-10-07)
- Prisma CLI 8.0.0-rc.21 GitHub release notes (read 2026-10-07)
- npm registry package metadata for prisma (read 2026-10-07)
- Prisma 7.10.0 CLI source bin.ts (read 2026-10-07)
- Prisma 7.10.0 CLI source CLI.ts (read 2026-10-07)
- Prisma 7.10.0 Studio source Studio.ts (read 2026-10-07)
- Prisma 7.10.0 global-local version mismatch warning source (read 2026-10-07)
- Prisma 8 RC CLI mounted commands source (read 2026-10-07)
- Prisma 8 CLI engine settlement and error reporting source (read 2026-10-07)
- npm download statistics for prisma (read 2026-10-07)
Last verified: 2026-10-07.