# @prisma/cli

> Command-line interface for the Prisma Developer Platform.

Latest version **8.0.0-rc.25** (published 2026-10-22) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @prisma/cli
pnpm add @prisma/cli
yarn add @prisma/cli
bun add @prisma/cli
```

Provides the command `prisma-cli`.

## Health

**Score 65/100 (B)** — status: active.

Positive: esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 8.0.0-rc.25 |
| Published | 2026-10-22 |
| First published | 2019-05-31 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | ESM |
| Node | ^22.18.0 \|\| ^24.11.0 \|\| >=26.0.0 |
| Dependencies | 12 |
| Unpacked size | 566.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 23 |
| Maintainers | prismabot, aqrln, wmadden-prisma, rtbenfield |
| Keywords | prisma, cli, database, app, deployment |

## Links

- npm: https://www.npmjs.com/package/@prisma/cli
- Repository: https://github.com/prisma/prisma-cli
- Homepage: https://github.com/prisma/prisma-cli#readme
- Issues: https://github.com/prisma/prisma-cli/issues
- npm.io page: https://npm.io/package/@prisma/cli

## Dependencies (12)

- [open](https://npm.io/package/open.md) ^11.0.0
- [execa](https://npm.io/package/execa.md) ^9.6.1
- [dotenv](https://npm.io/package/dotenv.md) ^17.4.2
- [cross-spawn](https://npm.io/package/cross-spawn.md) ^7.0.6
- [better-result](https://npm.io/package/better-result.md) ^2.9.2
- [@manypkg/tools](https://npm.io/package/@manypkg/tools.md) ^2.1.2
- [@prisma/cli-engine](https://npm.io/package/@prisma/cli-engine.md) 0.9.0
- [@prisma/compute-sdk](https://npm.io/package/@prisma/compute-sdk.md) 0.43.0
- [@prisma/composer-cli](https://npm.io/package/@prisma/composer-cli.md) 0.33.0
- [@vercel/detect-agent](https://npm.io/package/@vercel/detect-agent.md) ^1.2.3
- [@prisma/orm-toolchain](https://npm.io/package/@prisma/orm-toolchain.md) 8.0.0-rc.19
- [@prisma/management-api-sdk](https://npm.io/package/@prisma/management-api-sdk.md) 1.80.0

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 8.0.0-rc.25 (latest) — 2026-10-22
- 8.0.0-rc.25-dev.161 (dev) — 2026-10-22
- 8.0.0-rc.10 (next) — 2026-08-25
- 3.0.0-alpha.14 (preview) — 2026-05-27
- 2.16.0-integration-cli.1 (integration) — 2021-02-02
- 2.13.1-dev.2 (patch-dev) — 2020-12-17
- 2.0.0-alpha.1314 (alpha) — 2020-06-09
- 8.0.0-rc.24 — 2026-10-21
- 8.0.0-rc.24-dev.158 — 2026-10-21
- 8.0.0-rc.23-dev.157 — 2026-10-21
- 8.0.0-rc.23-dev.156 — 2026-10-20
- 8.0.0-rc.23-dev.155 — 2026-10-19
- 8.0.0-rc.23-dev.153 — 2026-10-15
- 8.0.0-rc.23-dev.152 — 2026-10-15
- 8.0.0-rc.23 — 2026-10-15
- … 1977 more at https://npm.io/package/@prisma/cli/versions

## README

# Prisma CLI

Release candidate of the unified Prisma CLI.

This repository contains the unified Prisma command-line experience: one
binary for the ORM, Composer, and the Prisma Developer Platform — projects,
branches, services, service versions, environment variables, and the Prisma ORM
schema and migration workflow.

The 8.0.0 release candidates publish as `prisma` (binary `prisma`) and
`@prisma/cli` (binary `prisma-cli`) on the `latest` dist-tag.

## Install

```bash
pnpm add -D @prisma/cli
pnpm prisma-cli --help
```

Example workflow:

```bash
pnpm prisma-cli auth login
pnpm prisma-cli project create my-app
pnpm prisma-cli git connect git@github.com:owner/repo.git
pnpm prisma-cli project env add --file .env --role preview
pnpm prisma-cli project env list --role preview
```

Deployments start from pushing the connected repository, the Console, or `prisma-cli deploy`.

## Local Development

Requirements:

- Node.js 24.11 or newer on the 24 line, or 26 or newer
- pnpm 10+

Install dependencies:

```bash
pnpm install
```

Run the source CLI:

```bash
pnpm prisma --help
```

Run tests:

```bash
pnpm test
```

Build the package:

```bash
pnpm build:cli
```

Inspect the npm package locally without publishing:

```bash
pnpm --filter @prisma/cli pack --dry-run
```

## Command Model

The CLI groups commands by developer workflow:

- `auth`
- `project`
- `git`
- `branch`
- `postgres`
- `bucket`
- `service`

The canonical command shape is:

```text
prisma <group> <action>
```

The package includes project, environment-variable, service and service-version inspection, promotion, rollback, and deletion commands, plus the Prisma ORM (`contract`, `db`, `migration`, `orm init`) and Composer workflows (root `dev` and `deploy`, with `dev url`, `dev stop` and `emulator list`), and the `postgres` and `bucket` resource groups. The product model intentionally avoids product-specific namespaces.

## Documentation

The public docs start at `docs/README.md`.

Product behavior is defined in `docs/product`.

Start here when changing command behavior:

1. `docs/product/command-principles.md`
2. `docs/product/cli-style-guide.md`
3. `docs/product/output-conventions.md`
4. `docs/product/error-conventions.md`

See `CONTRIBUTING.md` for local development and contribution guidance.
See `ARCHITECTURE.md` for the short architecture entrypoint.

The npm package README lives at `packages/cli/README.md`.

## Community

Issues and feedback are welcome while the CLI is a release candidate. Pull
requests should be tied to an existing issue or maintainer agreement so product
behavior, docs, and tests stay aligned.

Please follow `CODE_OF_CONDUCT.md` in project spaces. Security reports should
use `SECURITY.md`, not public issues.

## Examples

Manual smoke apps live in:

- `examples/hello-world`
- `examples/next-smoke`

They are intentionally not part of the root pnpm workspace. Install dependencies
inside an example only when you want to run manual end-to-end checks.

## Publishing

Publishing happens through the `Publish to npm` GitHub Actions workflow. Do not
publish from a local checkout unless the release owner explicitly asks you to do
so. The full policy and procedure live in `docs/oss/versioning.md`.

The committed root `package.json` version (mirrored across the workspace in
lockstep) is the release source of truth. The workflow publishes
`@prisma/cli-engine` and then `@prisma/cli`.

Release channels:

- `latest`: releases on the Prisma 8 RC line (`8.0.0-rc.N`). A merged
  `chore(release)` PR that bumps the root version (via `pnpm bump-version`)
  publishes automatically; `workflow_dispatch` is the manual escape hatch and
  the dry-run path.
- `dev`: latest successful `main` build. Every push to `main` that does not
  change the root version publishes `<base>-dev.N` under the `dev` dist-tag.
  Commit traceability comes from npm provenance and the GitHub Actions run.
- PR preview packages: trusted same-repo pull requests get an installable
  pkg.pr.new comment for the exact commit. Fork PRs do not publish preview
  packages automatically. Preview publishing is best-effort and requires the
  pkg.pr.new GitHub App to be installed for this repository. Once that app is
  installed, set the repository variable `CLI_PR_PREVIEW_REQUIRED=true` to make
  preview publishing failures block CI.

For a release: run `pnpm bump-version` on a branch, commit, open the release
PR, and merge it — the merge is the publish trigger (`docs/oss/versioning.md`
has the full procedure).

If a release workflow fails after the npm publish step, check npm before
rerunning. The package version may already be published even if the GitHub
Release creation failed.

---
_Source: https://npm.io/package/@prisma/cli · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._