PlanetScale CLI
The pscale CLI for PlanetScale MySQL and PostgreSQL databases: branches, deploy requests, SQL and diagnostics, with an agent guide
- 671 ★ on the repository
- Last commit
- Apache-2.0
Broad access
Why this level
- Changes schema and data in production databases
- Handles passwords and service tokens
Install
- Works in
Manual install
brew install planetscale/tap/pscalemacOS. Some commands also need brew install mysql-client@8.4.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Changes schema and data in production databases
- Handles passwords and service tokens
This is third-party code. Review the repository files before installing.
What it does
pscale manages PlanetScale databases from the terminal: organizations, databases, schema branches, deploy requests for Vitess migrations, access roles and passwords, and backups. The sql and shell commands run queries, while insights, inspect and metrics help with slow or locked databases. For agents the CLI prints a guide with pscale agent-guide and an installable skill file with pscale --skill, and every command supports JSON output. For MCP clients PlanetScale offers a separate hosted MCP server.
Who it is for. For developers and DevOps engineers who run databases on PlanetScale and want an agent to handle them.
Good fit when
- The agent should create a database branch and ship a migration via a deploy request
- You need to find out why a database is slow or locking
- You want to automate PlanetScale in scripts or GitHub Actions
Not a fit when
- Your databases are not on PlanetScale
- Your client only speaks MCP: the hosted PlanetScale MCP server fits better
Example request
Create an add-orders-index branch in the shop database and prepare a deploy request with the new indexLimitations
Requires a PlanetScale account, and the service is paid. Some commands need a MySQL client in PATH, and many commands work with only one engine. Availability and payment from Russia are unverified.
How to disable. Remove pscale with your package manager, for example brew uninstall pscale, and delete the skill file from the agent's skills folder if you added it.
FAQ
Is there an MCP server?
The README points MCP clients to the hosted PlanetScale MCP server in the docs; the CLI itself is for direct shell automation.
Where are change safety workflows?
In the separate planetscale/skills pack that the agent guide links to.
Discussion
No questions or reviews yet.
Related
CLI toolsPlanetScale Database Skills
planetscale-database-skills
Skills for agents working with databases: one subfolder per technology. Made by PlanetScale, with a separate plugin for Cursor
A PostgreSQL MCP server with index tuning, EXPLAIN plans, database health checks and a read-only mode
Two official Prisma MCP servers: a local one for migrations and Prisma Studio, and a remote one for managing Prisma Postgres databases
Supabase's official CLI: local stack, database migrations, Edge Functions deploys and type generation from the terminal
Instant REST and MCP over PostgreSQL: the agent reads an existing database through an MCP endpoint with no backend to write
Supabase's official MCP server: the agent manages tables, reads project config and queries data after an OAuth login
README in short
The README lists install options: Homebrew, scoop, deb and rpm packages, AUR, binaries and a Docker image. It also points to a GitHub Action and the hosted MCP server. For agents it mentions pscale agent-guide, pscale --skill, AGENTS.md and the planetscale/skills pack.