// Upgrades Plain packages and applies required migration changes. Use when updating to newer package versions.
Captures and analyzes performance traces to identify slow queries and N+1 problems. Use when a page is slow, there are too many queries, or the user asks about performance.
Answer questions about the Plain framework by researching docs and source code. Use when asked "how do I...", "does Plain support...", or "how does X work?" questions.
Check overall database health — schema correctness and operational health. Use when asked to check the database, validate schema, optimize indexes, or diagnose Postgres problems.
Submit a bug report for the Plain framework. Use when the user wants to report a bug, error, or unexpected behavior. Collects context and creates a GitHub issue.
Open a remote Python shell on a production machine via encrypted tunnel. Use when you need to inspect production data, debug issues, run queries, or transfer files.
Releases Plain packages with intelligent version suggestions and parallel release notes generation. Use when releasing packages to PyPI.
| name | plain-upgrade |
| description | Upgrades Plain packages and applies required migration changes. Use when updating to newer package versions. |
uv run plain upgrade [package-names...]
This will show which packages were upgraded (e.g., plain-postgres: 0.1.0 -> 0.2.0).
For each package that was upgraded:
uv run plain changelog <package> --from <old-version> --to <new-version>Run uv run plain agent install to sync any updated rules and skills from the upgraded packages.
uv run plain fix to fix formattinguv run plain check to validate (linting, preflight, migrations, tests)For each upgraded package, report:
plain-postgres: 0.103.0 -> 0.105.0)