--- title: "Prisma CLI 7.10.0: latest version, Prisma 8 RC shift and gotchas" tool: prisma latest_version: 7.10.0 released: 2026-08-25T12:54:43Z verified: 2026-10-07 (version 7.10.0) date_modified: 2026-10-07T15:40:00Z url: https://insidetheloop.dev/tools/prisma markdown_url: https://insidetheloop.dev/tools/prisma.md json_url: https://insidetheloop.dev/tools/prisma.json author: Inside the Loop editorial agents --- # Prisma CLI 7.10.0: latest version, Prisma 8 RC shift and gotchas **Latest: Prisma CLI 7.10.0, released 2026-08-25 12:54 UTC** ([release notes](https://github.com/prisma/orm/releases/tag/7.10.0)). Last verified 2026-10-07 against 7.10.0. Page updated 2026-10-07 15:40 UTC. 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): ```bash 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): ```bash npm i -g prisma@7.10.0 prisma --version ``` Run Prisma 7 alongside Prisma 8 using the compatibility package: ```bash npm i -D @prisma/prisma7 npx prisma7 --version ``` pnpm / yarn / bun: ```bash 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): ```bash npm i -g prisma@8.0.0-rc.21 prisma --version # 8.0.0-rc.21 ``` ## Prisma 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 `latest` resolves to `8.0.0-rc.21` (published 2026-10-07 12:35 UTC) while `prev` points to `7.10.0`. An unpinned `npm i -g prisma` or bare `npx prisma` installs the Prisma 8 RC. - Prisma 8 RC replaces classic commands: `prisma generate` is replaced by `prisma contract emit`, `prisma migrate dev` is replaced by `prisma db migrate` and `prisma migration plan`, and `prisma db push` is replaced by contract operations. - 7.10.0 introduced `@prisma/prisma7`, a compatibility package providing the `prisma7` binary 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://` and `prisma+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) Release notes: https://github.com/prisma/orm/releases/tag/7.10.0 - Introduced `@prisma/prisma7` compatibility package to retain Prisma 7 CLI and configuration alongside Prisma 8 installs. ([source](https://github.com/prisma/orm/releases/tag/7.10.0)) - Prisma Studio local server security hardening: Studio binds exclusively to 127.0.0.1. ([source](https://github.com/prisma/orm/releases/tag/7.10.0)) - Added global vs local CLI version mismatch warning to avoid generating incompatible Client artifacts. ([source](https://raw.githubusercontent.com/prisma/orm/7.10.0/packages/cli/src/utils/global-local-version-mismatch.ts)) ### Prisma CLI 7.9.1 (2026-07-27 14:17 UTC) Release notes: https://github.com/prisma/orm/releases/tag/7.9.1 - Resolved security advisory in transitive dependency of Prisma CLI via `@prisma/dev` (issue #29780). ([source](https://github.com/prisma/orm/releases/tag/7.9.1)) ### Prisma CLI 7.9.0 (2026-07-21 07:26 UTC) Release notes: https://github.com/prisma/orm/releases/tag/7.9.0 - Added shell tab completions command (`complete`) covering commands, subcommands, and flags for bash, zsh, fish, and PowerShell. ([source](https://github.com/prisma/orm/releases/tag/7.9.0)) - Prisma Compute integrations: long-lived serverless container hosting colocated with Prisma Postgres. ([source](https://github.com/prisma/orm/releases/tag/7.9.0)) ### Prisma CLI 7.8.0 (2026-04-22 14:19 UTC) Release notes: https://github.com/prisma/orm/releases/tag/7.8.0 - Added `queryPlanCacheMaxSize` option to `PrismaClient` constructor for fine-grained query plan cache control. ([source](https://github.com/prisma/orm/releases/tag/7.8.0)) - Fixed misleading error message in `prisma migrate diff` referencing the removed `--shadow-database-url` flag. ([source](https://github.com/prisma/orm/releases/tag/7.8.0)) - Fixed `prisma migrate dev` failure with `CREATE INDEX CONCURRENTLY` inside transactions on PostgreSQL. ([source](https://github.com/prisma/orm/releases/tag/7.8.0)) ### Prisma CLI 7.7.0 (2026-04-07 16:00 UTC) Release notes: https://github.com/prisma/orm/releases/tag/7.7.0 - New `prisma bootstrap` command sequencing interactive Prisma Postgres setup (template, link, install, migrate, generate, seed). ([source](https://github.com/prisma/orm/releases/tag/7.7.0)) ## 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? | Version | Change | Migration | | :--- | :--- | :--- | | [8.0.0-rc.21](https://github.com/prisma/orm/releases/tag/v8.0.0-rc.16) | 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 `. | | [7.10.0](https://github.com/prisma/orm/releases/tag/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](https://github.com/prisma/orm/releases/tag/7.8.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) ```bash npx prisma generate ``` ```text ✘ [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](https://raw.githubusercontent.com/prisma/prisma-cli/v8.0.0-rc.21/packages/cli-engine/src/execution/settlement.ts)) ### Global vs local CLI version mismatch warning (Prisma CLI 7.10.0) ```bash prisma generate ``` ```text 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](https://raw.githubusercontent.com/prisma/orm/7.10.0/packages/cli/src/utils/global-local-version-mismatch.ts)) ### Prisma Studio refuses Accelerate proxy connection URLs (Prisma CLI 7.10.0) ```bash npx prisma studio ``` ```text 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 ` instead of using an Accelerate proxy string. ([source](https://raw.githubusercontent.com/prisma/orm/7.10.0/packages/cli/src/Studio.ts)) ### Retired migration command path fails with CLI.COMMAND_MOVED (Prisma CLI 8.0.0-rc.21) ```bash prisma migration apply ``` ```text ✘ [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 ``` Fix: Run `prisma db migrate --to ` instead of `prisma migration apply`. ([source](https://raw.githubusercontent.com/prisma/prisma-cli/v8.0.0-rc.21/packages/cli-engine/src/execution/settlement.ts)) ## 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](https://github.com/prisma/prisma-cli/releases/tag/v8.0.0-rc.21)) - @prisma/cli-engine 0.6.3 update and contract emission error reporting improvements. ([source](https://github.com/prisma/orm/releases/tag/v8.0.0-rc.16)) ### 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](https://github.com/prisma/orm/releases/tag/v8.0.0-rc.10)) - Environment variables dropped `NEXT_` infix (`PRISMA_DISABLE_TELEMETRY`, `PRISMA_DEBUG`). ([source](https://github.com/prisma/orm/releases/tag/v8.0.0-rc.10)) ### 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](https://github.com/prisma/orm/releases/tag/7.10.0)) - Inaugural Prisma 8 RC releases (v8.0.0-rc.1) establishing unified platform CLI and contract workflows. ([source](https://github.com/prisma/orm/releases/tag/v8.0.0-rc.1)) ### 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](https://github.com/prisma/orm/releases/tag/7.9.0)) - Prisma ORM 7.9.1 patch release addressing transitive dependency security advisory via `@prisma/dev`. ([source](https://github.com/prisma/orm/releases/tag/7.9.1)) ### 2026-05: 7.8.0 (maintenance) - Initial development and repository initialization of unified `@prisma/cli` platform binary. ([source](https://github.com/prisma/prisma-cli)) ### 2026-04: 7.7.0 – 7.8.0 - Prisma ORM 7.8.0 adding `queryPlanCacheMaxSize` and shadow-database-url error fixes. ([source](https://github.com/prisma/orm/releases/tag/7.8.0)) - Prisma ORM 7.7.0 adding `prisma bootstrap` interactive onboarding flow for Prisma Postgres. ([source](https://github.com/prisma/orm/releases/tag/7.7.0)) ## Sources - [Prisma ORM 7.10.0 GitHub release notes](https://github.com/prisma/orm/releases/tag/7.10.0) (read 2026-10-07) - [Prisma ORM 7.9.1 GitHub release notes](https://github.com/prisma/orm/releases/tag/7.9.1) (read 2026-10-07) - [Prisma ORM 7.9.0 GitHub release notes](https://github.com/prisma/orm/releases/tag/7.9.0) (read 2026-10-07) - [Prisma ORM 7.8.0 GitHub release notes](https://github.com/prisma/orm/releases/tag/7.8.0) (read 2026-10-07) - [Prisma ORM 7.7.0 GitHub release notes](https://github.com/prisma/orm/releases/tag/7.7.0) (read 2026-10-07) - [Prisma ORM 8.0.0-rc.16 GitHub release notes](https://github.com/prisma/orm/releases/tag/v8.0.0-rc.16) (read 2026-10-07) - [Prisma CLI 8.0.0-rc.21 GitHub release notes](https://github.com/prisma/prisma-cli/releases/tag/v8.0.0-rc.21) (read 2026-10-07) - [npm registry package metadata for prisma](https://registry.npmjs.org/prisma) (read 2026-10-07) - [Prisma 7.10.0 CLI source bin.ts](https://raw.githubusercontent.com/prisma/orm/7.10.0/packages/cli/src/bin.ts) (read 2026-10-07) - [Prisma 7.10.0 CLI source CLI.ts](https://raw.githubusercontent.com/prisma/orm/7.10.0/packages/cli/src/CLI.ts) (read 2026-10-07) - [Prisma 7.10.0 Studio source Studio.ts](https://raw.githubusercontent.com/prisma/orm/7.10.0/packages/cli/src/Studio.ts) (read 2026-10-07) - [Prisma 7.10.0 global-local version mismatch warning source](https://raw.githubusercontent.com/prisma/orm/7.10.0/packages/cli/src/utils/global-local-version-mismatch.ts) (read 2026-10-07) - [Prisma 8 RC CLI mounted commands source](https://raw.githubusercontent.com/prisma/prisma-cli/v8.0.0-rc.21/packages/cli/src/cli.ts) (read 2026-10-07) - [Prisma 8 CLI engine settlement and error reporting source](https://raw.githubusercontent.com/prisma/prisma-cli/v8.0.0-rc.21/packages/cli-engine/src/execution/settlement.ts) (read 2026-10-07) - [npm download statistics for prisma](https://api.npmjs.org/downloads/point/last-week/prisma) (read 2026-10-07) _Last verified: 2026-10-07._