Install the cloud extension

The platform is the @putnami/cloud extension. Add it to your workspace and the putnami CLI gains the cloud commands and the deploy / publish verbs.

Extensions teach the CLI new capabilities; the cloud extension is the one that connects a workspace to Putnami Cloud. It is a normal Putnami extension — auto-discovered, no separate binary to manage.

Add it

putnami deps add @putnami/cloud

This records @putnami/cloud in your workspace and installs it. Extensions are auto-discovered from:

  1. Workspace-level entries in putnami.workspace.json → extensions
  2. Scope-level entries in a scope putnami.json → extensions
  3. Project-level devDependencies in package.json

If you edit the manifest by hand, run putnami deps install to reconcile.

What it adds

Group Commands
Identity putnami cloud login, logout, whoami
Workspace putnami cloud setup, token, sql-proxy
Registries putnami cloud registries, registry-token
Config putnami cloud config, secrets, cache
Publish putnami cloud publish-config, publish-migration, publish-archives, publish-doc
Deploy putnami deploy, putnami cloud deploy
Release putnami publish

See the CLI reference for every command and flag.

Verify

putnami cloud

This prints the cloud command help. If you see the command list, the extension is installed and discovered.

About the install hook

Installing the extension runs a one-time ensure step (cloud setup --auto). It is a no-op unless this repository is already linked to a Cloud workspace and you are already signed in — it never creates a workspace and never fails the install. On a fresh checkout it does nothing; you drive setup explicitly in the next two steps.

Next