Upgrade Putnami

You want to keep Putnami up to date — the CLI, extensions, and framework dependencies in your projects.

One command

putnami upgrade

This upgrades everything in sequence:

1. CLI — downloads the latest release binary
2. Extensions — resolves latest compatible versions of @putnami/typescript, @putnami/go, @putnami/python, etc.
3. Templates — updates workspace templates
4. Framework dependencies — upgrades @putnami/* packages (TypeScript), go.putnami.dev/* modules (Go), and Python framework packages

The output shows what changed at each step:

  CLI
  Already up to date (1.2.0)

  Extensions
  ↑ @putnami/typescript: 1.2.0 → 1.3.0
  ✓ @putnami/go@2.1.0 (up to date)

  Templates
  ✓ typescript-web@1.0.0 (up to date)

  Dependencies
  ✓ @putnami/application updated
  ✓ @putnami/web updated

Upgrade specific layers

Use flags to upgrade only what you need:

putnami upgrade --cli          # Only the CLI binary
putnami upgrade --extensions   # Only extensions and templates
putnami upgrade --deps         # Only framework dependencies

After upgrading

Verify everything still works:

putnami lint,test,build --impacted

If the upgrade included breaking changes, the build or test output will surface what needs updating. Use --output=jsonl for structured diagnostics if you need to pinpoint exact failures.

Low-level commands

The putnami upgrade command orchestrates these individual commands, which you can also run directly:

What	Command
CLI binary	putnami version update
Extensions	putnami extensions update
Templates	putnami templates update
Dependencies	Handled by extension deps-upgrade jobs

For version management (switching between installed CLI versions):

putnami version list              # See what's installed
putnami version use go-1.3.0      # Switch to a specific version

You now have a fully updated Putnami workspace — CLI, extensions, and project dependencies.