{
  "tool": "prisma",
  "name": "Prisma CLI",
  "long_name": "Prisma CLI (prisma)",
  "aliases": [
    "prisma-cli",
    "prisma-orm",
    "@prisma/cli",
    "prisma-8"
  ],
  "homepage": "https://www.prisma.io/docs/orm/tools/prisma-cli",
  "url": "https://insidetheloop.dev/tools/prisma",
  "markdown_url": "https://insidetheloop.dev/tools/prisma.md",
  "date_modified": "2026-10-07T15:40:00Z",
  "title": "Prisma CLI 7.10.0: latest version, Prisma 8 RC shift and gotchas",
  "description": "Prisma CLI 7.10.0 (2026-08-25 UTC): upgrade commands, source diffs, Prisma 8 RC default shift, removed generate command, and version mismatch warnings.",
  "answer": "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`.",
  "latest": {
    "version": "7.10.0",
    "released_at": "2026-08-25T12:54:43Z",
    "url": "https://github.com/prisma/orm/releases/tag/7.10.0"
  },
  "upgrade": [
    {
      "label": "Pin latest stable Prisma 7 (recommended for existing projects)",
      "command": "npm i -D prisma@7.10.0 @prisma/client@7.10.0\nnpx prisma --version   # 7.10.0"
    },
    {
      "label": "npm global install (pinned to stable Prisma 7)",
      "command": "npm i -g prisma@7.10.0\nprisma --version"
    },
    {
      "label": "Run Prisma 7 alongside Prisma 8 using the compatibility package",
      "command": "npm i -D @prisma/prisma7\nnpx prisma7 --version"
    },
    {
      "label": "pnpm / yarn / bun",
      "command": "pnpm add -D prisma@7.10.0 @prisma/client@7.10.0\nyarn add -D prisma@7.10.0 @prisma/client@7.10.0\nbun add -d prisma@7.10.0 @prisma/client@7.10.0"
    },
    {
      "label": "Install Prisma 8 RC line (new unified platform CLI)",
      "command": "npm i -g prisma@8.0.0-rc.21\nprisma --version   # 8.0.0-rc.21"
    }
  ],
  "verified": {
    "date": "2026-10-07",
    "version": "7.10.0",
    "method": "from source (not run): inspected release notes, tag compare API diffs (7.6.0..7.10.0 in prisma/orm and v8.0.0-rc.1..rc.21 in prisma/prisma-cli), command declarations in packages/cli/src/bin.ts and packages/cli/src/CLI.ts, and npm registry dist-tags."
  },
  "updated_at": "2026-10-07T15:40:00Z",
  "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."
  ],
  "releases": [
    {
      "version": "7.10.0",
      "released_at": "2026-08-25T12:54:43Z",
      "url": "https://github.com/prisma/orm/releases/tag/7.10.0",
      "changes": [
        {
          "text": "Introduced `@prisma/prisma7` compatibility package to retain Prisma 7 CLI and configuration alongside Prisma 8 installs.",
          "url": "https://github.com/prisma/orm/releases/tag/7.10.0"
        },
        {
          "text": "Prisma Studio local server security hardening: Studio binds exclusively to 127.0.0.1.",
          "url": "https://github.com/prisma/orm/releases/tag/7.10.0"
        },
        {
          "text": "Added global vs local CLI version mismatch warning to avoid generating incompatible Client artifacts.",
          "url": "https://raw.githubusercontent.com/prisma/orm/7.10.0/packages/cli/src/utils/global-local-version-mismatch.ts"
        }
      ]
    },
    {
      "version": "7.9.1",
      "released_at": "2026-07-27T14:17:54Z",
      "url": "https://github.com/prisma/orm/releases/tag/7.9.1",
      "changes": [
        {
          "text": "Resolved security advisory in transitive dependency of Prisma CLI via `@prisma/dev` (issue #29780).",
          "url": "https://github.com/prisma/orm/releases/tag/7.9.1"
        }
      ]
    },
    {
      "version": "7.9.0",
      "released_at": "2026-07-21T07:26:50Z",
      "url": "https://github.com/prisma/orm/releases/tag/7.9.0",
      "changes": [
        {
          "text": "Added shell tab completions command (`complete`) covering commands, subcommands, and flags for bash, zsh, fish, and PowerShell.",
          "url": "https://github.com/prisma/orm/releases/tag/7.9.0"
        },
        {
          "text": "Prisma Compute integrations: long-lived serverless container hosting colocated with Prisma Postgres.",
          "url": "https://github.com/prisma/orm/releases/tag/7.9.0"
        }
      ]
    },
    {
      "version": "7.8.0",
      "released_at": "2026-04-22T14:19:23Z",
      "url": "https://github.com/prisma/orm/releases/tag/7.8.0",
      "changes": [
        {
          "text": "Added `queryPlanCacheMaxSize` option to `PrismaClient` constructor for fine-grained query plan cache control.",
          "url": "https://github.com/prisma/orm/releases/tag/7.8.0"
        },
        {
          "text": "Fixed misleading error message in `prisma migrate diff` referencing the removed `--shadow-database-url` flag.",
          "url": "https://github.com/prisma/orm/releases/tag/7.8.0"
        },
        {
          "text": "Fixed `prisma migrate dev` failure with `CREATE INDEX CONCURRENTLY` inside transactions on PostgreSQL.",
          "url": "https://github.com/prisma/orm/releases/tag/7.8.0"
        }
      ]
    },
    {
      "version": "7.7.0",
      "released_at": "2026-04-07T16:00:33Z",
      "url": "https://github.com/prisma/orm/releases/tag/7.7.0",
      "changes": [
        {
          "text": "New `prisma bootstrap` command sequencing interactive Prisma Postgres setup (template, link, install, migrate, generate, seed).",
          "url": "https://github.com/prisma/orm/releases/tag/7.7.0"
        }
      ]
    }
  ],
  "surface": [
    {
      "from": "7.9.1",
      "to": "7.10.0",
      "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.",
      "summary": "0 commands added, 0 removed; CLI definitions unchanged; added distribution identity and local version mismatch detector.",
      "commands_added": [],
      "commands_removed": [],
      "flags": [],
      "notes": [
        "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."
      ]
    },
    {
      "from": "7.9.0",
      "to": "7.9.1",
      "method": "from source (not run): compared repository file changes across tags 7.9.0 and 7.9.1 via GitHub API.",
      "summary": "0 commands added, 0 removed; patch release bumping transitive dependency @prisma/dev.",
      "commands_added": [],
      "commands_removed": [],
      "flags": [],
      "notes": [
        "A security patch release that bumped `@prisma/dev` to resolve issue #29780. No CLI command, option, or behavior changed."
      ]
    },
    {
      "from": "7.8.0",
      "to": "7.9.0",
      "method": "from source (not run): compared packages/cli/src/bin.ts across tags 7.8.0 and 7.9.0 via GitHub API.",
      "summary": "1 command added, 0 removed: complete added for shell tab completions.",
      "commands_added": [
        "complete"
      ],
      "commands_removed": [],
      "flags": [],
      "notes": [
        "`complete` (`Completions.new()`) was mounted in `packages/cli/src/bin.ts` to output shell completion scripts for bash, zsh, fish, and PowerShell."
      ]
    },
    {
      "from": "7.6.0",
      "to": "7.7.0",
      "method": "from source (not run): compared packages/cli/src/bin.ts across tags 7.6.0 and 7.7.0 via GitHub API.",
      "summary": "1 command added, 0 removed: bootstrap added for interactive project onboarding.",
      "commands_added": [
        "bootstrap"
      ],
      "commands_removed": [],
      "flags": [],
      "notes": [
        "`bootstrap` (`Bootstrap.new()`) was mounted in `packages/cli/src/bin.ts` to provide a single interactive flow for starter scaffolding, linking, and schema migrations."
      ]
    },
    {
      "from": "7.10.0",
      "to": "8.0.0-rc.21",
      "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.",
      "summary": "Major architecture shift: 70 commands added (platform, compute, contracts, migrations), 16 legacy commands removed (generate, migrate dev, db push).",
      "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"
      ],
      "flags": [],
      "notes": [
        "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`."
      ]
    }
  ],
  "breaking": [
    {
      "version": "8.0.0-rc.21",
      "change": "Prisma 8 RC unified CLI retires `prisma generate`, `prisma migrate dev`, and `prisma db push`.",
      "migrate": "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>`.",
      "url": "https://github.com/prisma/orm/releases/tag/v8.0.0-rc.16"
    },
    {
      "version": "7.10.0",
      "change": "Prisma Studio local server binds exclusively to IPv4 loopback 127.0.0.1 and drops Accelerate URL support.",
      "migrate": "Pass a direct database URL (`postgresql://...`) rather than a `prisma://` or `prisma+postgres://` proxy connection string when launching Prisma Studio.",
      "url": "https://github.com/prisma/orm/releases/tag/7.10.0"
    },
    {
      "version": "7.0.0",
      "change": "`--shadow-database-url` CLI flag was removed from `prisma migrate diff` in Prisma 7.",
      "migrate": "Configure shadow database parameters in `prisma.config.ts` or project datasource configuration instead of passing `--shadow-database-url` on the command line.",
      "url": "https://github.com/prisma/orm/releases/tag/7.8.0"
    }
  ],
  "gotchas": [
    {
      "title": "Unpinned npx prisma generate fails on Prisma 8 RC with unknown command",
      "version": "8.0.0-rc.21",
      "command": "npx prisma generate",
      "output": "✘ [CLI.UNKNOWN_COMMAND] unknown command \"generate\"\n  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`.",
      "url": "https://raw.githubusercontent.com/prisma/prisma-cli/v8.0.0-rc.21/packages/cli-engine/src/execution/settlement.ts"
    },
    {
      "title": "Global vs local CLI version mismatch warning",
      "version": "7.10.0",
      "command": "prisma generate",
      "output": "warn The globally installed prisma@7.10.0 does not match the local package @prisma/client@7.9.1 installed in this project.\nThis may generate Prisma Client artifacts that are incompatible with the local runtime.\nRun 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.",
      "url": "https://raw.githubusercontent.com/prisma/orm/7.10.0/packages/cli/src/utils/global-local-version-mismatch.ts"
    },
    {
      "title": "Prisma Studio refuses Accelerate proxy connection URLs",
      "version": "7.10.0",
      "command": "npx prisma studio",
      "output": "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.",
      "url": "https://raw.githubusercontent.com/prisma/orm/7.10.0/packages/cli/src/Studio.ts"
    },
    {
      "title": "Retired migration command path fails with CLI.COMMAND_MOVED",
      "version": "8.0.0-rc.21",
      "command": "prisma migration apply",
      "output": "✘ [CLI.COMMAND_MOVED] `migration apply` has been replaced\n  why: Applying a migration is a move to a target contract, not a verb of its own.\n→ Use the replacement: prisma db migrate --to <contract>",
      "fix": "Run `prisma db migrate --to <contract>` instead of `prisma migration apply`.",
      "url": "https://raw.githubusercontent.com/prisma/prisma-cli/v8.0.0-rc.21/packages/cli-engine/src/execution/settlement.ts"
    }
  ],
  "monthly": [
    {
      "month": "2026-10",
      "versions": "8.0.0-rc.15 – 8.0.0-rc.21",
      "highlights": [
        {
          "text": "Prisma 8 RC line iterations: v8.0.0-rc.21 published to npm dist-tag `latest`, ArkType 2.2 engine toolchain alignment.",
          "url": "https://github.com/prisma/prisma-cli/releases/tag/v8.0.0-rc.21"
        },
        {
          "text": "@prisma/cli-engine 0.6.3 update and contract emission error reporting improvements.",
          "url": "https://github.com/prisma/orm/releases/tag/v8.0.0-rc.16"
        }
      ]
    },
    {
      "month": "2026-09",
      "versions": "8.0.0-rc.9 – 8.0.0-rc.14",
      "highlights": [
        {
          "text": "Renamed Prisma Next to Prisma 8 across CLI identifiers and configuration files (v8.0.0-rc.10).",
          "url": "https://github.com/prisma/orm/releases/tag/v8.0.0-rc.10"
        },
        {
          "text": "Environment variables dropped `NEXT_` infix (`PRISMA_DISABLE_TELEMETRY`, `PRISMA_DEBUG`).",
          "url": "https://github.com/prisma/orm/releases/tag/v8.0.0-rc.10"
        }
      ]
    },
    {
      "month": "2026-08",
      "versions": "7.10.0, 8.0.0-rc.1 – 8.0.0-rc.8",
      "highlights": [
        {
          "text": "Prisma ORM 7.10.0 stable release introducing `@prisma/prisma7` compatibility package and Studio security hardening.",
          "url": "https://github.com/prisma/orm/releases/tag/7.10.0"
        },
        {
          "text": "Inaugural Prisma 8 RC releases (v8.0.0-rc.1) establishing unified platform CLI and contract workflows.",
          "url": "https://github.com/prisma/orm/releases/tag/v8.0.0-rc.1"
        }
      ]
    },
    {
      "month": "2026-07",
      "versions": "7.9.0 – 7.9.1",
      "highlights": [
        {
          "text": "Prisma ORM 7.9.0 stable release adding shell tab completions (`prisma complete`) and Prisma Compute.",
          "url": "https://github.com/prisma/orm/releases/tag/7.9.0"
        },
        {
          "text": "Prisma ORM 7.9.1 patch release addressing transitive dependency security advisory via `@prisma/dev`.",
          "url": "https://github.com/prisma/orm/releases/tag/7.9.1"
        }
      ]
    },
    {
      "month": "2026-05",
      "versions": "7.8.0 (maintenance)",
      "highlights": [
        {
          "text": "Initial development and repository initialization of unified `@prisma/cli` platform binary.",
          "url": "https://github.com/prisma/prisma-cli"
        }
      ]
    },
    {
      "month": "2026-04",
      "versions": "7.7.0 – 7.8.0",
      "highlights": [
        {
          "text": "Prisma ORM 7.8.0 adding `queryPlanCacheMaxSize` and shadow-database-url error fixes.",
          "url": "https://github.com/prisma/orm/releases/tag/7.8.0"
        },
        {
          "text": "Prisma ORM 7.7.0 adding `prisma bootstrap` interactive onboarding flow for Prisma Postgres.",
          "url": "https://github.com/prisma/orm/releases/tag/7.7.0"
        }
      ]
    }
  ],
  "sources": [
    {
      "title": "Prisma ORM 7.10.0 GitHub release notes",
      "url": "https://github.com/prisma/orm/releases/tag/7.10.0",
      "read": "2026-10-07"
    },
    {
      "title": "Prisma ORM 7.9.1 GitHub release notes",
      "url": "https://github.com/prisma/orm/releases/tag/7.9.1",
      "read": "2026-10-07"
    },
    {
      "title": "Prisma ORM 7.9.0 GitHub release notes",
      "url": "https://github.com/prisma/orm/releases/tag/7.9.0",
      "read": "2026-10-07"
    },
    {
      "title": "Prisma ORM 7.8.0 GitHub release notes",
      "url": "https://github.com/prisma/orm/releases/tag/7.8.0",
      "read": "2026-10-07"
    },
    {
      "title": "Prisma ORM 7.7.0 GitHub release notes",
      "url": "https://github.com/prisma/orm/releases/tag/7.7.0",
      "read": "2026-10-07"
    },
    {
      "title": "Prisma ORM 8.0.0-rc.16 GitHub release notes",
      "url": "https://github.com/prisma/orm/releases/tag/v8.0.0-rc.16",
      "read": "2026-10-07"
    },
    {
      "title": "Prisma CLI 8.0.0-rc.21 GitHub release notes",
      "url": "https://github.com/prisma/prisma-cli/releases/tag/v8.0.0-rc.21",
      "read": "2026-10-07"
    },
    {
      "title": "npm registry package metadata for prisma",
      "url": "https://registry.npmjs.org/prisma",
      "read": "2026-10-07"
    },
    {
      "title": "Prisma 7.10.0 CLI source bin.ts",
      "url": "https://raw.githubusercontent.com/prisma/orm/7.10.0/packages/cli/src/bin.ts",
      "read": "2026-10-07"
    },
    {
      "title": "Prisma 7.10.0 CLI source CLI.ts",
      "url": "https://raw.githubusercontent.com/prisma/orm/7.10.0/packages/cli/src/CLI.ts",
      "read": "2026-10-07"
    },
    {
      "title": "Prisma 7.10.0 Studio source Studio.ts",
      "url": "https://raw.githubusercontent.com/prisma/orm/7.10.0/packages/cli/src/Studio.ts",
      "read": "2026-10-07"
    },
    {
      "title": "Prisma 7.10.0 global-local version mismatch warning source",
      "url": "https://raw.githubusercontent.com/prisma/orm/7.10.0/packages/cli/src/utils/global-local-version-mismatch.ts",
      "read": "2026-10-07"
    },
    {
      "title": "Prisma 8 RC CLI mounted commands source",
      "url": "https://raw.githubusercontent.com/prisma/prisma-cli/v8.0.0-rc.21/packages/cli/src/cli.ts",
      "read": "2026-10-07"
    },
    {
      "title": "Prisma 8 CLI engine settlement and error reporting source",
      "url": "https://raw.githubusercontent.com/prisma/prisma-cli/v8.0.0-rc.21/packages/cli-engine/src/execution/settlement.ts",
      "read": "2026-10-07"
    },
    {
      "title": "npm download statistics for prisma",
      "url": "https://api.npmjs.org/downloads/point/last-week/prisma",
      "read": "2026-10-07"
    }
  ],
  "fixes": []
}