prisma

Prisma CLI

Quickstart • Commands • Beta notes • Documentation • 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:

npm install --save-dev prisma@next

Run the binary exposed by this package:

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:

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

Useful next commands:

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:

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
• Command principles
• Output conventions
• Error conventions

Support

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

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.

Security reports should follow Prisma's security policy and should not be filed as public issues.

License

Apache-2.0