Skip to main content
Prisma Documentation Docs

Search documentation

Type to search this documentation.

On this pageOverview

init

init prepares the current directory for Prisma development. It runs locally and calls no platform API. It does not scaffold the ORM: use orm init to add the Prisma ORM config, contract, and runtime files to a project.

init does three things:

  1. Adds a postinstall script to package.json (prisma skills sync || exit 0), so the Prisma agent skills resync on every install and upgrade.
  2. Scaffolds a prisma.config.ts recording which agents to install skills for, in the skills config section.
  3. Runs skills sync once.

It never prompts, always exits 0, and is safe to rerun: each step reports what is already done. A prisma.config.ts or postinstall script that already exists is never edited. If package.json already has a different postinstall script, init reports it and tells you what to append instead of chaining or replacing it.

title="bun"
bunx --bun prisma@latest init
pnpm
pnpm dlx prisma@latest init
yarn
yarn dlx prisma@latest init
npm
npx prisma@latest init
Option What it does
--skills <agents> Agents to install skills for, comma-separated: claude, cursor, agents, devin. Pass none to record that no agent skills are wanted. Default: all of them.
--postinstall/--no-postinstall Add the skills-sync postinstall hook. --no-postinstall skips that step.
title="bun"
bunx --bun prisma@latest init

bunx --bun prisma@latest init --skills=claude,cursor

bunx --bun prisma@latest init --skills=none

bunx --bun prisma@latest init --no-postinstall
pnpm
pnpm dlx prisma@latest init
pnpm dlx prisma@latest init --skills=claude,cursor
pnpm dlx prisma@latest init --skills=none
pnpm dlx prisma@latest init --no-postinstall
yarn
yarn dlx prisma@latest init
yarn dlx prisma@latest init --skills=claude,cursor
yarn dlx prisma@latest init --skills=none
yarn dlx prisma@latest init --no-postinstall
npm
npx prisma@latest init
npx prisma@latest init --skills=claude,cursor
npx prisma@latest init --skills=none
npx prisma@latest init --no-postinstall

init writes a minimal prisma.config.ts when none exists:

title="prisma.config.ts"
import { definePrismaConfig } from "prisma/config";

export default definePrismaConfig({

  skills: {

    agents: ["claude", "cursor", "agents", "devin"],

  },

});

The prisma/config import resolves from your project's node_modules, so add prisma as a dev dependency before running other commands against this file. See Configuration.

Only init writes the postinstall hook. No other command edits package.json; skills sync itself never touches it.

Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu