CLI reference
The @putnami/cloud extension adds the Cloud commands below. Commands that
return records support --output=jsonl for scripts and agents; use
putnami cloud <command> --help for the installed command's complete flags.
Deploy and release
| Command | Does | Key flags |
|---|---|---|
putnami deploy |
Publish a deployable project and release a revision | --env, --wait, --timeout, --preview, --force, --image-version |
putnami publish |
Publish project artifacts, config, migrations, and release outputs | --env, --archives, --stable, --channel |
putnami cloud deploy |
Direct/synchronous deploy path; can re-read a release with deploy status <release-id> |
--app, --env, --wait, --preview, --force |
putnami cloud status |
Show project, environment, serving revision, and health | --env, --workspace, --provenance |
Identity and workspace
| Command | Does | Key flags |
|---|---|---|
putnami cloud login |
Sign in with OAuth device authorization | --no-open, --client-id, --scope |
putnami cloud logout |
Clear local Cloud credentials and revoke reachable registry tokens | |
putnami cloud whoami |
Show the active identity | --output=jsonl |
putnami cloud setup |
Link the repository and install Intelligence/audit wiring | --workspace, --workspace-name, --environment, --intelligence, --audit, --intelligence-workspace, --force-audit, --no-cache, --auto |
putnami cloud token |
Mint a workspace, global operator, cache, or registry bearer for a script | --global or --for cache|npm|go|oci|registry |
putnami cloud tokens |
Create, list, or revoke workspace-owned machine tokens | create, list, revoke |
putnami cloud source |
Connect, inspect, or disconnect the workspace GitHub repository | connect, status, disconnect, --repo, --replace |
Configuration and data access
| Command | Does | Key flags |
|---|---|---|
putnami cloud config |
Inspect resolved project config or its published schema | --schema, --key, --env, --secret-keys, --with-secrets |
putnami cloud secrets |
Manage workspace and project secrets | --block, --field, --from-stdin, --from-file, --reveal, --yes |
putnami cloud db |
Request/list/revoke time-boxed database access or open a local bridge | grant request|list|revoke, connect, --database, --level, --reason, --ttl |
putnami cloud sql-proxy |
Operator/emergency Cloud SQL Auth Proxy path | --instance, --port |
Observability and delivery evidence
| Command | Does | Key flags |
|---|---|---|
putnami cloud logs |
Query or live-tail application logs | --app, --since, --level, --follow, --cursor |
putnami cloud metrics |
Query application metric series | --app, --window, --from, --to, --cursor |
putnami cloud traces |
Query traces and filter slow requests | --app, --slow, --from, --to, --cursor |
putnami cloud report |
Submit a delivery-run conclusion for the current pushed commit | --status, --conclusion |
putnami cloud audit-attest |
Get, set, or batch-prefetch immutable Intelligence audit attestations | get|set|prefetch, --repo, --project, --group, --input-hash, --rubric-hash |
Registries and cache
| Command | Does | Key flags |
|---|---|---|
putnami cloud registries |
List or manage per-registry personal access tokens | --registry |
putnami cloud registry-token |
Resolve a registry bearer by host | --host |
putnami cloud oci |
Copy or retag OCI images server-side | copy <src> <dst>, retag <ref> <tag…> |
putnami cloud cache |
Show or disable remote-cache configuration | --remove |
Direct publishers
| Command | Does | Key flags |
|---|---|---|
putnami cloud publish-config |
Register an app schema and publish conf/env.<env>.yaml |
--app, --env, --dry-run |
putnami cloud publish-migration |
Publish a workload migration bundle | --app, --bundle-from, --bundle-version, --channel |
putnami cloud publish-archives |
Publish pre-built extension archives | --app, --channel, --stable |
putnami cloud publish-doc |
Publish every docs/<site>/<section>/ tree as a site-content bundle |
--source, --section, --channel, --dry-run |