@astrojs/upgrade

@astrojs/upgrade is a small CLI for upgrading astro and all @astrojs/* dependencies in a project. Published from packages/upgrade/.

Purpose

Run npx @astrojs/upgrade (or pnpm dlx @astrojs/upgrade) inside an Astro project. The tool:

1. Detects the package manager.
2. Resolves the latest versions of astro, create-astro, every @astrojs/* integration, and astro-vscode.
3. Prints a diff of versions about to change.
4. Optionally runs the upgrade with the right pnpm / npm / yarn / bun invocation.

It is the recommended way to bump major versions because it keeps the framework and adapter/integration versions aligned (mismatched versions often produce confusing runtime errors).

Directory layout

packages/upgrade/
├── src/
├── test/
└── package.json

The CLI uses @clack/prompts for interaction, similar to create-astro.

Related pages

• packages / create-astro — the same interaction style applied to project creation.
• packages / astro