postman-cli 1.53.0 → 1.54.0

package/man/postman.1

@@ -1,4 +1,4 @@
-.TH POSTMAN 1 "2026-09-02" "v1.53.0" "Postman CLI Manual"
+.TH POSTMAN 1 "2026-09-03" "v1.54.0" "Postman CLI Manual"
 .SH NAME
 postman \- Command\-line companion utility for Postman
 .SH SYNOPSIS
@@ -52,6 +52,65 @@ Delete the stored Postman API key.
 Specify the alias of the API key to fetch your resources using it.
 (This option is discontinued and will be removed in a future release.)
 
+.SS "init"
+Set up Postman artifacts and agent instructions in a repository.
+
+.B Usage:
+[options] [path]
+
+.B Options:
+.TP
+.B \-\-json
+Emit machine\-readable output for agents
+.TP
+.B \-\-dry\-run
+Report what would happen without writing anything
+.TP
+.B \-\-no\-seed
+Do not derive a spec from source
+.TP
+.B \-\-spec <path>
+Which spec is authoritative, when more than one could be
+.TP
+.B \-\-visibility <status>
+Create and bind a workspace non\-interactively (personal or team)
+.TP
+.B \-\-no\-cloud
+Skip the workspace step entirely
+.TP
+.B \-\-report\-events
+Send init analytics to Postman (requires login)
+
+.TP Examples:
+
+Runs entirely locally: no authentication, no network, safe in CI.
+
+Not the same as `postman app init`, which writes a postman.config.cjs
+for test\-traffic capture.
+
+Exit codes:
+  0  set up, or adopted an existing setup
+  1  init could not run: bad usage, or an unexpected error
+  2  several specs could be authoritative \- re\-run with \-\-spec <path>
+  4  refused: postman/ holds source files, or a binding names a missing file
+  5  local setup done, but the workspace \-\-visibility asked for was not made
+
+Code 5 needs \-\-visibility: without it no workspace was requested, so nothing
+can fail for not getting one. It does not mean re\-run init \- the local files
+are already written.
+
+Under \-\-json, read `exitCode` and `refusal` from the payload rather than
+matching the messages on stderr. `refusal.kind` is one of
+foreign\-postman\-dir, bound\-spec\-missing, spec\-hint\-unmatched.
+
+Examples:
+  $ postman init
+  $ postman init ./services/api \-\-json
+  $ postman init \-\-dry\-run
+  $ postman init \-\-spec postman/specs/orders.yaml
+  $ postman init \-\-visibility personal
+
+
 .SS "collection"
 Run and test your Postman collections directly from the command line.
 
@@ -590,6 +649,9 @@ Push local workspace entities (collections, environments, specifications, and mo
 .B workspace lint
 Lint the current local Postman workspace: its configuration (.postman/resources.yaml) plus every discovered entity. Use \-\-meta to lint only the configuration.
 .TP
+.B workspace create
+Create a Postman workspace and bind it to this git repository.
+.TP
 .B workspace pull
 Pull workspace entities from a Postman workspace into the local git\-native folder.
 .TP
@@ -689,6 +751,43 @@ The workspace ID to use for fetching governance rulesets. Defaults to the id in
 .B \-\-fix
 Apply safe autofixes to repairable workspace lint issues.
 
+.SS "workspace create"
+Create a Postman workspace and bind it to this git repository.
+
+.B Usage:
+[options]
+
+.B Options:
+.TP
+.B \-\-visibility <status>
+Required. Workspace visibility, e.g. personal or team
+.TP
+.B \-\-name <name>
+Workspace name (defaults to owner/repo from the git remote)
+.TP
+.B \-\-summary <text>
+Optional workspace summary
+.TP
+.B \-\-path <dir>
+Directory to bind (defaults to the current directory)
+.TP
+.B \-\-no\-connect
+Create the workspace without binding it to the repository
+.TP
+.B \-\-force
+Create even when a workspace is already recorded for this repo
+
+.TP Examples:
+
+Requires a login (`postman login`) or POSTMAN_API_KEY.
+Refuses to run on CI: create once locally and commit the binding.
+
+Examples:
+  $ postman workspace create \-\-visibility personal
+  $ postman workspace create \-\-visibility team \-\-name "acme/orders"
+  $ postman workspace create \-\-visibility personal \-\-no\-connect
+
+
 .SS "workspace pull"
 Pull workspace entities from a Postman workspace into the local git\-native folder.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postman-cli",
-  "version": "1.53.0",
+  "version": "1.54.0",
   "description": "Official Postman CLI - Command-line companion for API development, testing, and automation",
   "keywords": [
     "postman",
@@ -58,10 +58,10 @@
     "man/"
   ],
   "optionalDependencies": {
-    "@postman/pm-bin-macos-arm64": "1.53.0",
-    "@postman/pm-bin-macos-x64": "1.53.0",
-    "@postman/pm-bin-linux-x64": "1.53.0",
-    "@postman/pm-bin-linux-arm64": "1.53.0",
-    "@postman/pm-bin-windows-x64": "1.53.0"
+    "@postman/pm-bin-macos-arm64": "1.54.0",
+    "@postman/pm-bin-macos-x64": "1.54.0",
+    "@postman/pm-bin-linux-x64": "1.54.0",
+    "@postman/pm-bin-linux-arm64": "1.54.0",
+    "@postman/pm-bin-windows-x64": "1.54.0"
   }
 }