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:

Workspace-level entries in putnami.workspace.json → extensions
Scope-level entries in a scope putnami.json → extensions
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`
CI	`putnami cloud ci`, `track`
Intelligence	`putnami cloud intelligence`, `audit-attest`
Local validation	`putnami cloud validate-config`

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.

Measure agent readiness in any repository

You do not need a workspace or this extension to measure how far coding agents can work alone in a git repository. Run this line from the repository's directory:

curl -fsSL "https://putnami.dev/install.sh?run=agent-readiness" | bash

It installs the putnami CLI, pins the @putnami/intelligence extension for your user, and runs putnami agent-readiness. It writes nothing into the repository. See Measure agent readiness for what it sends and prints.