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/cloudThis records @putnami/cloud in your workspace and installs it. Extensions are
auto-discovered from:
- Workspace-level entries in
putnami.workspace.json→extensions - Scope-level entries in a scope
putnami.json→extensions - Project-level
devDependenciesinpackage.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 cloudThis 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
- Log in
- Agent and CI environments: install and read the build cache where nobody signs in