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 publish verb.

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, status, token, source
Packages putnami cloud registries, packages, channels, cache
Config and data putnami cloud config, secrets, db
Deploy putnami cloud env, deploy, callers
Release putnami publish
CI putnami cloud ci
Observability putnami cloud logs, traces, metrics
Intelligence (@putnami/intelligence) putnami intelligence setup, review, audit-attest, provenance

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. Install never touches your native credential files (~/.npmrc, ~/.netrc, the Docker config) — only putnami cloud login, putnami cloud registries setup, and putnami cloud logout do.

Next