Prisma CLI リファレンス

すべての Prisma CLI コマンドの完全なリファレンスです。このスキルは、現在の Prisma リリースのコマンド使用法、オプション、ベストプラクティスに関するガイダンスを提供します。

適用対象

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

• 新しい Prisma プロジェクトのセットアップ (prisma init)
• Prisma Client の生成 (prisma generate)
• データベースマイグレーションの実行 (prisma migrate)
• データベース状態の管理 (prisma db push/pull)
• ローカル開発データベースの使用 (prisma dev)
• Prisma の問題のデバッグ (prisma debug)

優先度別ルールカテゴリ

優先度	カテゴリ	影響度	プリフィックス
1	セットアップ	HIGH	init
2	生成	HIGH	generate
3	開発	HIGH	dev
4	データベース	HIGH	db-
5	マイグレーション	CRITICAL	migrate-
6	ユーティリティ	MEDIUM	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	スキーママイグレーション
ユーティリティ	studio, mcp, version, debug	開発と AI ツーリング

クイックリファレンス

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

# 新しいプロジェクトを初期化（prisma/ フォルダと prisma.config.ts を作成）
prisma init

# 特定のデータベースで初期化
prisma init --datasource-provider postgresql
prisma init --datasource-provider mysql
prisma init --datasource-provider sqlite

# Prisma Postgres（クラウド）で初期化
prisma init --db

# サンプルモデルを含めて初期化
prisma init --with-model

クライアント生成

# Prisma Client を生成
prisma generate

# 開発用ウォッチモード
prisma generate --watch

# 特定のジェネレータのみ生成
prisma generate --generator client

Bun ランタイム

Bun を使用する場合は、常に --bun フラグを追加し、Prisma が Bun ランタイムで実行されるようにします（そうしないと、CLI shebang のため Node.js にフォールバックします）：

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

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

# ローカル Prisma Postgres を起動
prisma dev

# 特定の名前で起動
prisma dev --name myproject

# バックグラウンドで起動（detached）
prisma dev --detach

# すべてのローカルインスタンスをリスト表示
prisma dev ls

# インスタンスを停止
prisma dev stop myproject

# インスタンスデータを削除
prisma dev rm myproject

データベース操作

# 既存のデータベースからスキーマを取得
prisma db pull

# スキーマをデータベースにプッシュ（マイグレーションなし）
prisma db push

# データベースをシード
prisma db seed

# 生の SQL を実行
prisma db execute --file ./script.sql

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

# マイグレーションを作成して適用
prisma migrate dev

# 名前を指定してマイグレーションを作成
prisma migrate dev --name add_users_table

# マイグレーションを作成して適用しない
prisma migrate dev --create-only

# データベースをリセットしてすべてのマイグレーションを適用
prisma migrate reset

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

# 保留中のマイグレーションを適用（CI/CD）
prisma migrate deploy

# マイグレーションステータスを確認
prisma migrate status

# スキーマを比較して diff を生成
prisma migrate diff --from-config-datasource --to-schema schema.prisma --script

ユーティリティコマンド

# Prisma Studio（データベース GUI）を開く
prisma studio

# Prisma の MCP サーバーを AI ツール用に起動
prisma mcp

# バージョン情報を表示
prisma version
prisma -v

# デバッグ情報
prisma debug

# スキーマを検証
prisma validate

# スキーマをフォーマット
prisma format

現在の 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           - プロジェクト初期化
references/generate.md       - クライアント生成
references/dev.md            - ローカル開発データベース
references/db-pull.md        - データベースイントロスペクション
references/db-push.md        - スキーマプッシュ
references/db-seed.md        - データベースシーディング
references/db-execute.md     - 生 SQL 実行
references/migrate-dev.md    - 開発マイグレーション
references/migrate-deploy.md - 本番マイグレーション
references/migrate-reset.md  - データベースリセット
references/migrate-status.md - マイグレーションステータス
references/migrate-resolve.md - マイグレーション解決
references/migrate-diff.md   - スキーマ比較
references/studio.md         - データベース GUI
references/mcp.md            - Prisma MCP サーバー
references/validate.md       - スキーマ検証
references/format.md         - スキーマフォーマット
references/debug.md          - デバッグ情報

使用方法

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