# prisma

> The Prisma CLI: one binary for the ORM, Composer, and the Prisma Developer Platform.

Latest version **8.0.0-rc.19** (published 2026-09-29) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install prisma
pnpm add prisma
yarn add prisma
bun add prisma
```

Provides the command `prisma`.

## 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.19 |
| Published | 2026-09-29 |
| First published | 2016-06-03 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | ESM |
| Node | >=22.18.0 |
| Dependencies | 12 |
| Unpacked size | 581.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 23 |
| Maintainers | prismabot |
| Keywords | prisma, cli, orm, database, deployment |

## Links

- npm: https://www.npmjs.com/package/prisma
- 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

## 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.6.2
- [@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.25.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.13
- [@prisma/management-api-sdk](https://npm.io/package/@prisma/management-api-sdk.md) 1.80.0

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 8.0.0-rc.19 (latest) — 2026-09-29
- 8.0.0-rc.19-dev.136 (dev) — 2026-09-30
- 7.10.0 (prev) — 2026-08-25
- 8.0.0-rc.10 (next) — 2026-08-25
- 7.10.0-integration-fix-prisma-publish-token.1 (integration) — 2026-08-17
- 7.9.1-dev.1 (patch-dev) — 2026-07-27
- 5.19.0-integration-feat-typed-sql.14 (typed-sql) — 2024-08-22
- 5.17.0-dev.33 (optimize) — 2024-07-12
- 5.12.0-dev.21 (early-access) — 2024-03-19
- 5.4.0-dev.61 (turso) — 2023-09-28
- 8.0.0-rc.19-dev.135 — 2026-09-29
- 8.0.0-rc.18-dev.134 — 2026-09-29
- 8.0.0-rc.18-dev.133 — 2026-09-29
- 8.0.0-rc.18 — 2026-09-29
- 8.0.0-rc.18-dev.132 — 2026-09-29
- … 9340 more at https://npm.io/package/prisma/versions

## README

<p align="center">
  <img src="https://i.imgur.com/h6UIYTu.png" alt="Prisma" width="360" />
</p>

# Prisma CLI

[![npm version](https://img.shields.io/npm/v/prisma?label=npm)](https://www.npmjs.com/package/prisma)
[![license](https://img.shields.io/npm/l/prisma)](https://github.com/prisma/prisma-cli/blob/main/LICENSE)
[![Node.js](https://img.shields.io/node/v/prisma)](https://www.npmjs.com/package/prisma)

[Quickstart](#quickstart) • [Commands](#commands) • [Beta notes](#beta-notes) • [Documentation](#documentation) • [Support](#support)

---

`prisma` is the public beta of the new CLI for the
Prisma Developer Platform.

It is 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.

---

## Quickstart

Install the beta package locally:

```bash
npm install --save-dev prisma@next
```

Run the binary exposed by this package:

```bash
npx prisma --help
npx prisma auth login
npx prisma project create my-app
npx prisma git connect git@github.com:owner/repo.git
```

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

With `pnpm`:

```bash
pnpm add -D prisma@next
pnpm prisma auth login
pnpm prisma git connect
```

Useful next commands:

```bash
npx prisma service list
npx prisma service logs
npx prisma project env add DATABASE_URL=postgresql://example --role preview
npx prisma project env add --file .env --role preview
npx prisma project env list
npx prisma project env list --role preview
```

---

## Commands

| Group | What it does |
| --- | --- |
| `auth` | Log in, log out, and inspect the active Prisma account. |
| `project` | List, create, link, and manage projects and their environment variables. |
| `git` | Connect or disconnect a project from a GitHub repository; pushes deploy. |
| `branch` | List Prisma branches for the resolved project. |
| `postgres` | Create, inspect, back up, restore, and delete Prisma Postgres databases and their connections. |
| `bucket` | Create, list, and delete object-store buckets and their access keys. |
| `service` | Inspect services: versions, logs, domains, promote, roll back, delete. |
| `dev`, `deploy` | Run a Composer app locally; deploy it to the platform. |
| `contract`, `db`, `migration`, `orm init`, `lsp` | The Prisma ORM workflow. |

Common examples:

```bash
npx prisma --version
npx prisma auth whoami
npx prisma project show
npx prisma branch list
npx prisma service list
npx prisma service version promote VERSION_ID
```

### Built for humans, CI, and agents

- Human-readable output by default.
- `--json` for structured output.
- `--no-interactive` and `--yes` for automation.
- `PRISMA_SERVICE_TOKEN` for headless authenticated commands.
- Stable command groups, flags, and error codes for scripts and agents.
- Environment variable values are not printed back to the terminal.

---

## Beta notes

- Requires Node.js 22.18 or newer.
- This is a release-candidate package and may change quickly.
- The 8.0.0 release candidates publish as `prisma` on the `next` dist-tag.
- The package binary is `prisma`.
- Local project context is cached in `.prisma/local.json`, which is gitignored and not a declarative repo config file.

---

## Documentation

- [CLI docs index](https://github.com/prisma/prisma-cli/blob/main/docs/README.md)
- [Command principles](https://github.com/prisma/prisma-cli/blob/main/docs/product/command-principles.md)
- [Output conventions](https://github.com/prisma/prisma-cli/blob/main/docs/product/output-conventions.md)
- [Error conventions](https://github.com/prisma/prisma-cli/blob/main/docs/product/error-conventions.md)

## Support

Send a bug report or feature request directly from your terminal:

```bash
npx prisma feedback "Describe what happened and what you expected"
```

Feedback is anonymous by default. Add `--email you@example.com` if you want a
reply. Submissions include your message, CLI and runtime versions, OS platform,
and architecture. Review your message for secrets before sending.

For a public discussion, use [GitHub issues](https://github.com/prisma/prisma-cli/issues).

Security reports should follow Prisma's
[security policy](https://github.com/prisma/prisma-cli/blob/main/SECURITY.md)
and should not be filed as public issues.

## License

Apache-2.0

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