{"id":50483318,"url":"https://github.com/prisma/prisma-cli","last_synced_at":"2026-06-01T19:31:03.761Z","repository":{"id":356064096,"uuid":"1229654799","full_name":"prisma/prisma-cli","owner":"prisma","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-28T08:14:14.000Z","size":531,"stargazers_count":3,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-28T09:24:53.578Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/prisma.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-05T09:01:08.000Z","updated_at":"2026-05-28T08:14:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/prisma/prisma-cli","commit_stats":null,"previous_names":["prisma/prisma-cli"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/prisma/prisma-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prisma%2Fprisma-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prisma%2Fprisma-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prisma%2Fprisma-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prisma%2Fprisma-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prisma","download_url":"https://codeload.github.com/prisma/prisma-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prisma%2Fprisma-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33790704,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-01T02:00:06.963Z","response_time":115,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-01T19:31:02.660Z","updated_at":"2026-06-01T19:31:03.755Z","avatar_url":"https://github.com/prisma.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Prisma CLI\n\nBeta of the unified Prisma CLI.\n\nThis repository contains the unified Prisma command-line experience. The current\nimplementation focuses on app deployment workflows while preserving the\nlong-term command model for Prisma projects, branches, schemas, databases, and\napps.\n\nOfficial beta releases use the primary `@prisma/cli` package line. The package\nexposes a `prisma-cli` binary so it can coexist with the existing `prisma`\nexecutable.\n\n## Install\n\n```bash\npnpm add -D @prisma/cli\npnpm prisma-cli --help\n```\n\nExample workflow:\n\n```bash\npnpm prisma-cli auth login\npnpm prisma-cli app deploy --env DATABASE_URL=postgresql://example\npnpm prisma-cli project env list --role preview\n```\n\nIf you want local project scripts that look like the future command shape, add:\n\n```json\n{\n  \"scripts\": {\n    \"prisma\": \"prisma-cli\"\n  }\n}\n```\n\nThen run:\n\n```bash\npnpm prisma app deploy\n```\n\n## Local Development\n\nRequirements:\n\n- Node.js 20+\n- pnpm 10+\n\nInstall dependencies:\n\n```bash\npnpm install\n```\n\nRun the source CLI:\n\n```bash\npnpm prisma --help\n```\n\nRun tests:\n\n```bash\npnpm test\npnpm lint:skills\npnpm test:skills\n```\n\n`pnpm install` also wires the local skill cluster into supported agent\nruntimes, including `.agents/skills/` and `.claude/skills/`.\n\nBuild the package:\n\n```bash\npnpm build:cli\n```\n\nStage the npm package locally without publishing:\n\n```bash\npnpm build:cli\npnpm prepare:cli-publish\n```\n\n## Command Model\n\nThe CLI groups commands by developer workflow:\n\n- `auth`\n- `project`\n- `git`\n- `branch`\n- `app`\n\nThe canonical command shape is:\n\n```text\nprisma \u003cgroup\u003e \u003caction\u003e\n```\n\nThe beta package includes app build, run, deploy, environment-variable,\ndeployment inspection, promotion, rollback, and removal commands. The product\nmodel intentionally keeps room for future schema, database, and migration\nworkflows without introducing product-specific namespaces.\n\n## Documentation\n\nThe public docs start at `docs/README.md`.\n\nAgent skills for guided Next.js deploys live in `skills/`. Install the cluster\ninto an app project with:\n\n```bash\npnpm dlx skills@latest add prisma/prisma-cli/skills#cli-v\u003ccli-version\u003e --all\n```\n\nProduct behavior is defined in `docs/product`.\n\nStart here when changing command behavior:\n\n1. `docs/product/resource-model.md`\n2. `docs/product/command-principles.md`\n3. `docs/product/command-spec.md`\n4. `docs/product/cli-style-guide.md`\n5. `docs/product/output-conventions.md`\n6. `docs/product/error-conventions.md`\n\nSee `CONTRIBUTING.md` for local development and contribution guidance.\nSee `ARCHITECTURE.md` for the short architecture entrypoint.\n\nThe npm package README lives at `packages/cli/README.md` and is copied into the\nstaged publish artifact.\n\n## Community\n\nIssues and feedback are welcome while the CLI is in public beta. Pull\nrequests should be tied to an existing issue or maintainer agreement so product\nbehavior, docs, and tests stay aligned.\n\nPlease follow `CODE_OF_CONDUCT.md` in project spaces. Security reports should\nuse `SECURITY.md`, not public issues.\n\n## Examples\n\nManual smoke apps live in:\n\n- `examples/hello-world`\n- `examples/next-smoke`\n\nThey are intentionally not part of the root pnpm workspace. Install dependencies\ninside an example only when you want to run manual end-to-end checks.\n\n## Publishing\n\nPublishing happens through the `Publish CLI` GitHub Actions workflow. Do not\npublish from a local checkout unless the release owner explicitly asks you to do\nso.\n\nThe committed `packages/cli/package.json` version is a development placeholder.\nRelease versions are injected by CI when the staged npm package is prepared.\n\nRelease channels:\n\n- `@prisma/cli` / `latest`: official beta releases. Run `Publish CLI` manually;\n  it computes the next `3.0.0-beta.N`, publishes with the `latest` dist-tag, and\n  creates `cli-v\u003cversion\u003e`.\n- `@prisma/cli@dev`: latest successful `main` build. Every push to `main`\n  publishes a unique `3.0.0-dev.\u003crun_number\u003e.\u003crun_attempt\u003e` version with the\n  `dev` dist-tag. Commit traceability comes from npm provenance and the GitHub\n  Actions run.\n- PR preview packages: trusted same-repo pull requests get an installable\n  pkg.pr.new comment for the exact commit. Fork PRs do not publish preview\n  packages automatically. Preview publishing is best-effort and requires the\n  pkg.pr.new GitHub App to be installed for this repository. Once that app is\n  installed, set the repository variable `CLI_PR_PREVIEW_REQUIRED=true` to make\n  preview publishing failures block CI.\n\nFor an official beta release:\n\n1. Run `Publish CLI` with `dry_run: true`.\n2. Check the computed version and package checks.\n3. Run `Publish CLI` with `dry_run: false`.\n\nIf a release workflow fails after the npm publish step, check npm before\nrerunning. The package version may already be published even if tag creation\nfailed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprisma%2Fprisma-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprisma%2Fprisma-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprisma%2Fprisma-cli/lists"}