Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
# Prisma CLI

Beta of the unified 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 `next` dist-tag.
`@prisma/cli` (binary `prisma-cli`) on the `latest` dist-tag.

## Install

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

Expand Down Expand Up @@ -74,9 +74,9 @@ The CLI groups commands by developer workflow:
- `project`
- `git`
- `branch`
- `database`
- `postgres`
- `bucket`
- `app`
- `service`

The canonical command shape is:

Expand Down Expand Up @@ -106,7 +106,7 @@ The npm package README lives at `packages/cli/README.md`.

## Community

Issues and feedback are welcome while the CLI is in public beta. Pull
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.

Expand Down
2 changes: 1 addition & 1 deletion docs/reference/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ output, and implementation.
| Structured output | Explicit `--json` output intended for automation. | [Output conventions](../product/output-conventions.md) |
| Human output | Status, prompts, summaries, and decoration intended for terminal users. | [Output conventions](../product/output-conventions.md) |
| Error code | Stable machine-readable failure code. | [Error conventions](../product/error-conventions.md) |
| Beta package | Public prerelease package line for `@prisma/cli`; the RC line publishes on the `next` dist-tag (see [versioning](../oss/versioning.md)). | [ADR 0001](../architecture/adrs/0001-preview-package-and-publishing.md) |
| Beta package | Public prerelease package line for `@prisma/cli`; the RC line publishes on the `latest` dist-tag (see [versioning](../oss/versioning.md)). | [ADR 0001](../architecture/adrs/0001-preview-package-and-publishing.md) |
| Dev package | Latest successful `main` build of `@prisma/cli` on the `dev` dist-tag. | [ADR 0001](../architecture/adrs/0001-preview-package-and-publishing.md) |
| PR preview package | Installable pkg.pr.new package for a trusted same-repo pull request commit. | [ADR 0001](../architecture/adrs/0001-preview-package-and-publishing.md) |

Expand Down
2 changes: 1 addition & 1 deletion examples/hello-world/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ Fresh external scaffold:
mkdir my-bun-app
cd my-bun-app
bun init --yes
pnpm add -D @prisma/cli@next
pnpm add -D @prisma/cli
```

Then replace `index.ts` with a `Bun.serve(...)` server and run:
Expand Down
16 changes: 8 additions & 8 deletions packages/cli/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@
[![license](https://img.shields.io/npm/l/@prisma/cli)](https://github.com/prisma/prisma-cli/blob/main/LICENSE)
[![Node.js](https://img.shields.io/node/v/@prisma/cli)](https://www.npmjs.com/package/@prisma/cli)

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

---

`@prisma/cli` is the public beta of the new CLI for the
`@prisma/cli` is the release candidate of the new CLI for the
Prisma Developer Platform.

It is one binary for the ORM, Composer, and the Prisma Developer
Expand All @@ -23,10 +23,10 @@ variables, and the Prisma ORM schema and migration workflow.

## Quickstart

Install the beta package locally:
Install the package locally:

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

Run the binary exposed by this package:
Expand All @@ -43,7 +43,7 @@ Deployments start from pushing the connected repository, the Console, or `prisma
With `pnpm`:

```bash
pnpm add -D @prisma/cli@next
pnpm add -D @prisma/cli
pnpm prisma-cli auth login
pnpm prisma-cli git connect
```
Expand All @@ -59,7 +59,7 @@ npx prisma-cli project env list
npx prisma-cli project env list --role preview
```

The beta package exposes `prisma-cli` so it can coexist with the existing
This package exposes `prisma-cli` so it can coexist with the existing
`prisma` executable.

---
Expand Down Expand Up @@ -100,11 +100,11 @@ npx prisma-cli service version promote VERSION_ID

---

## Beta notes
## Release candidate 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/cli` on the `next` dist-tag.
- The 8.0.0 release candidates publish as `@prisma/cli` on the `latest` dist-tag.
Comment thread
gregory-boch-prisma marked this conversation as resolved.
- The package binary is `prisma-cli`; the sibling `prisma` package ships the same CLI under the `prisma` binary.
- Local project context is cached in `.prisma/local.json`, which is gitignored and not a declarative repo config file.

Expand Down
7 changes: 3 additions & 4 deletions packages/cli/src/cli-command.ts
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
import { CLI_NAME } from "./cli-name";

export const PRISMA_CLI_PACKAGE_NAME = "@prisma/cli";
// `next` is the RC line's canonical dist-tag (docs/oss/versioning.md);
// `latest` still serves the 3.x beta until the deliberate cutover, so a
// hint spelling `@latest` would bounce users into the pre-8 command set.
export const PRISMA_CLI_PACKAGE_SPEC = `${PRISMA_CLI_PACKAGE_NAME}@next`;
// `latest` is where every release publishes, RC line included; `next` is
// moved by hand and can lag (docs/oss/versioning.md).
export const PRISMA_CLI_PACKAGE_SPEC = `${PRISMA_CLI_PACKAGE_NAME}@latest`;
export const DEFAULT_PRISMA_CLI_PACKAGE_RUNNER = ["npx", "-y"];
export const PRISMA_CLI_BINARY = CLI_NAME;

Expand Down
14 changes: 7 additions & 7 deletions packages/prisma/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@
[![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)
[Quickstart](#quickstart) • [Commands](#commands) • [Release candidate notes](#release-candidate-notes) • [Documentation](#documentation) • [Support](#support)

---

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

It is one binary for the ORM, Composer, and the Prisma Developer
Expand All @@ -23,10 +23,10 @@ variables, and the Prisma ORM schema and migration workflow.

## Quickstart

Install the beta package locally:
Install the package locally:

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

Run the binary exposed by this package:
Expand All @@ -43,7 +43,7 @@ Deployments start from pushing the connected repository, the Console, or `prisma
With `pnpm`:

```bash
pnpm add -D prisma@next
pnpm add -D prisma
pnpm prisma auth login
pnpm prisma git connect
```
Expand Down Expand Up @@ -97,11 +97,11 @@ npx prisma service version promote VERSION_ID

---

## Beta notes
## Release candidate 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 8.0.0 release candidates publish as `prisma` on the `latest` 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.

Expand Down
Loading