prisma-cli

Prisma ORM 7 CLI リファレンス

これらのコマンドと例は Prisma ORM 7 のみに適用されます。セットアップ、接続の修復、または Prisma 8 アプリケーションについては、prisma-orm-setup を読み込んでください。

プロジェクトのバージョンに合った CLI を使用してください。これらのコマンドを実行するために、バージョン指定のない prisma@latest をインストールしないでください。

境界：プラットフォームとコンピューティング

安定版の ORM コマンド（prisma）と、パブリックベータ版の Platform パッケージ（@prisma/cli、バイナリ prisma-cli）を混同しないでください。Compute アプリとワークスペース認証には prisma-compute を、Platform プロジェクトとデータベースには prisma-postgres-setup を使用してください。

適用するタイミング

次の場合にこのスキルを参照してください：

• 明示的に選択した Prisma 7 プロジェクトをセットアップする（prisma init）
• Prisma Client を生成する（prisma generate）
• データベースのマイグレーションを実行する（prisma migrate）
• データベースの状態を管理する（prisma db push/pull）
• ローカル開発データベースを使用する（prisma dev）
• Prisma の問題をデバッグする（prisma debug）
• シェル補完を生成する（prisma complete）

優先度別のルールカテゴリ

優先度	カテゴリ	影響度	プレフィックス
1	セットアップ	高	init
2	生成	高	generate
3	開発	高	dev
4	データベース	高	db-
5	マイグレーション	重大	migrate-
6	ユーティリティ	中	complete, studio, validate, format, debug, mcp

コマンドカテゴリ

カテゴリ	コマンド	目的
セットアップ	init	Prisma プロジェクトを初期化する
生成	generate	Prisma Client を生成する
検証	validate, format	スキーマの検証とフォーマット
開発	dev	開発用のローカル Prisma Postgres
データベース	db pull, db push, db seed, db execute	データベースを直接操作する
マイグレーション	migrate dev, migrate deploy, migrate reset, migrate status, migrate diff, migrate resolve	スキーマのマイグレーション
ユーティリティ	complete, studio, mcp, version, debug	シェル、開発、AI ツール

クイックリファレンス

プロジェクトのセットアップ

# Initialize new project (creates prisma/ folder and prisma.config.ts)
prisma init

# Initialize with specific database
prisma init --datasource-provider postgresql
prisma init --datasource-provider mysql
prisma init --datasource-provider sqlite

# Initialize with Prisma Postgres (cloud)
prisma init --db

# Initialize with an example model
prisma init --with-model

クライアントの生成

# Generate Prisma Client
prisma generate

# Watch mode for development
prisma generate --watch

# Generate specific generator only
prisma generate --generator client

Bun ランタイム

Bun を使用する場合は、必ず --bun フラグを追加して、Prisma が Bun ランタイムで実行されるようにしてください（追加しない場合、CLI のシバンによって Node.js にフォールバックします）：

bunx --bun prisma init
bunx --bun prisma generate

ローカル開発データベース

# Start local Prisma Postgres
prisma dev

# Start with specific name
prisma dev --name myproject

# Start in background (detached)
prisma dev --detach

# List all local instances
prisma dev ls

# Stop instance
prisma dev stop myproject

# Remove instance data
prisma dev rm myproject

データベース操作

# Pull schema from existing database
prisma db pull

# Push schema to database (no migrations)
prisma db push

# Seed database
prisma db seed

# Execute raw SQL
prisma db execute --file ./script.sql

マイグレーション（開発）

# Create and apply migration
prisma migrate dev

# Create migration with name
prisma migrate dev --name add_users_table

# Create migration without applying
prisma migrate dev --create-only

# Reset database and apply all migrations
prisma migrate reset

マイグレーション（本番環境）

# Apply pending migrations (CI/CD)
prisma migrate deploy

# Check migration status
prisma migrate status

# Compare schemas and generate diff
prisma migrate diff --from-config-datasource --to-schema schema.prisma --script

ユーティリティコマンド

# Open Prisma Studio (database GUI)
prisma studio

# Start Prisma's MCP server for AI tools
prisma mcp

# Show version info
prisma version
prisma -v

# Debug information
prisma debug

# Validate schema
prisma validate

# Format schema
prisma format

# Generate shell completion code
prisma complete zsh

AI セーフティチェックポイント

Prisma は、AI エージェントを検出すると、エージェントがユーザーから明示的な同意を得るまで、破壊的なコマンドをブロックします。対象となるコマンドは migrate reset、db push --force-reset、db push --accept-data-loss です。

• コマンドを実行する直前に、データ損失の具体的な影響を説明し、同意を求めてください。
• 以前のメッセージや無関係なメッセージから同意を推測しないでください。
• 自動化で同意変数が必要な場合は、PRISMA_USER_CONSENT_FOR_DANGEROUS_AI_ACTION にユーザーの同意メッセージをそのまま設定してください。文面を捏造しないでください。
• Prisma MCP サーバーには、意図的に migrate-reset ツールがありません。

破壊的な Prisma コマンドを実行する前に、references/agent-safety.md を読んでください。

現在の Prisma CLI セットアップ

新しい設定ファイル

CLI の設定には prisma.config.ts を使用してください：

import 'dotenv/config'
import { defineConfig, env } from 'prisma/config'

export default defineConfig({
  schema: 'prisma/schema.prisma',
  migrations: {
    path: 'prisma/migrations',
    seed: 'tsx prisma/seed.ts',
  },
  datasource: {
    url: env('DATABASE_URL'),
  },
})

現在のコマンドの動作

• 新しいクライアント出力が必要な場合は、migrate dev、db push、またはその他のスキーマ同期の後に、明示的に prisma generate を実行してください
• シードデータが必要な場合は、migrate dev または migrate reset の後に、明示的に prisma db seed を実行してください
• 生 SQL スクリプトには prisma db execute --file ... を使用してください

環境変数

環境変数は prisma.config.ts で明示的に読み込みます。一般的には dotenv を使用します：

// prisma.config.ts
import 'dotenv/config'

ルールファイル

コマンドの詳細なドキュメントについては、各ルールファイルを参照してください：

references/init.md           - Project initialization
references/generate.md       - Client generation
references/dev.md            - Local development database
references/db-pull.md        - Database introspection
references/db-push.md        - Schema push
references/db-seed.md        - Database seeding
references/db-execute.md     - Raw SQL execution
references/migrate-dev.md    - Development migrations
references/migrate-deploy.md - Production migrations
references/migrate-reset.md  - Database reset
references/migrate-status.md - Migration status
references/migrate-resolve.md - Migration resolution
references/migrate-diff.md   - Schema diffing
references/studio.md         - Database GUI
references/mcp.md            - Prisma MCP server
references/complete.md       - Shell completion generation
references/agent-safety.md   - AI consent checkpoint for destructive commands
references/validate.md       - Schema validation
references/format.md         - Schema formatting
references/debug.md          - Debug info

使用方法

上記のコマンドカテゴリを使って移動し、必要な特定のコマンドのリファレンスファイルを開いてください。