postman-cli 1.37.0 → 1.38.1

package/man/postman.1

@@ -1,4 +1,4 @@
-.TH POSTMAN 1 "2026-05-18" "v1.37.0" "Postman CLI Manual"
+.TH POSTMAN 1 "2026-05-29" "v1.38.1" "Postman CLI Manual"
 .SH NAME
 postman \- Command\-line companion utility for Postman
 .SH SYNOPSIS
@@ -512,9 +512,6 @@ Pass condition in format: function(metric, value).
 Functions: less_than, greater_than, less_than_eq, greater_than_eq. 
 Metrics: avg, p90, p95, p99, error_rate, rps. 
 Example: less_than(p95, 500) or less_than(error_rate, 5)
-.TP
-.B \-\-persist\-metrics
-Persist detailed run results to cloud for analysis (default: false)
 
 .TP Examples:
 
@@ -1623,14 +1620,14 @@ Environment override for the selected target (last value wins) (default: )
 .B \-\-command <cmd>
 Command to run first (primary task). Overrides config.
 .TP
-.B \-\-network\-log <dir>
-Directory to scan for captured artifacts. Recursively discovers `playwright\-report*.json` plus their `trace.zip` attachments, and `network\-capture\-*.ndjson` (legacy plugin stream) at the top level. Use this to point at a non\-default Playwright `outputDir`, or at a folder where you have combined per\-shard artifacts from multiple machines. By default, scans Playwright config `outputDir`, test\-results/, then pm\-results/.
+.B \-\-network\-log <path>
+Directory to scan for captured artifacts, or a direct path to a Playwright JSON report / NDJSON capture file. When a directory is given, recursively discovers `*.json` Playwright reports plus their `trace.zip` attachments, and `network\-capture\-*.ndjson` at the top level. By default, scans Playwright config `outputDir`, test\-results/, then pm\-results/.
 .TP
 .B \-\-capture\-only
 Skip collection matching and tests; capture traffic and save a V3 collection organised by host
 .TP
 .B \-\-analyse\-only
-Do not run the primary command; analyse existing network\-capture NDJSON under the network log directory
+Do not run the primary command; analyse existing network\-capture NDJSON under the network log path
 .TP
 .B \-\-run\-only
 Run only the primary command; skip analysis (use \-\-analyse\-only on merged captures later).
@@ -1688,6 +1685,237 @@ Start mocks with fault\-injection scenarios defined in a .sim.yaml file
 .B Usage:
 [options] <filepath>
 
+.SS "context"
+[Beta] Get API context for AI coding agents directly from the command line.
+
+
+.B Usage:
+[options] [command]
+
+.B Subcommands:
+.TP
+.B context instructions
+Get agent instructions for using Postman Context with AI coding agents.
+
+Topics:
+  (none)          — Overview of capabilities, workflow, and API reference
+  discovery       — Agent instructions for searching for and exploring APIs
+  code\-generation — Agent instructions for generating and maintaining client code
+  maintenance     — Agent instructions for maintaining and updating client code
+
+.TP
+.B context collection
+Collection commands
+.TP
+.B context request
+Request commands
+.TP
+.B context folder
+Folder commands
+.TP
+.B context response
+Response commands
+.TP
+.B context workspace
+Workspace commands
+.TP
+.B context environment
+Environment commands
+
+.SS "context instructions"
+Get agent instructions for using Postman Context with AI coding agents.
+
+Topics:
+  (none)          — Overview of capabilities, workflow, and API reference
+  discovery       — Agent instructions for searching for and exploring APIs
+  code\-generation — Agent instructions for generating and maintaining client code
+  maintenance     — Agent instructions for maintaining and updating client code
+
+
+.B Usage:
+[options] [topic]
+
+.SS "context collection"
+Collection commands
+
+.B Usage:
+[options] [command]
+
+.B Subcommands:
+.TP
+.B context collection get
+Get a collection's metadata and a map of its folders and requests.
+
+Returns collection info (name, description, variables, auth) plus a
+recursive tree of folders and requests.
+
+.SS "context collection get"
+Get a collection's metadata and a map of its folders and requests.
+
+Returns collection info (name, description, variables, auth) plus a
+recursive tree of folders and requests.
+
+.B Usage:
+[options]
+
+.B Options:
+.TP
+.B \-c, \-\-collection\-id <id>
+Collection ID
+
+.SS "context request"
+Request commands
+
+.B Usage:
+[options] [command]
+
+.B Subcommands:
+.TP
+.B context request get
+Get a request from a collection
+.TP
+.B context request context
+Fetch all context about a request and return it as a Markdown document.
+
+Returns: collection metadata, request details (method, URL, headers, body,
+auth, docs), parent folder documentation, response examples, and
+environment variables.
+
+Examples:
+  postman context request context \-c <collection\-id> \-r <request\-id>
+
+.SS "context request get"
+Get a request from a collection
+
+.B Usage:
+[options]
+
+.B Options:
+.TP
+.B \-r, \-\-request\-id <id>
+Request ID
+.TP
+.B \-c, \-\-collection\-id <id>
+Collection ID
+
+.SS "context request context"
+Fetch all context about a request and return it as a Markdown document.
+
+Returns: collection metadata, request details (method, URL, headers, body,
+auth, docs), parent folder documentation, response examples, and
+environment variables.
+
+Examples:
+  postman context request context \-c <collection\-id> \-r <request\-id>
+
+.B Usage:
+[options]
+
+.B Options:
+.TP
+.B \-c, \-\-collection\-id <id>
+Collection ID
+.TP
+.B \-r, \-\-request\-id <id>
+Request ID
+
+.SS "context folder"
+Folder commands
+
+.B Usage:
+[options] [command]
+
+.B Subcommands:
+.TP
+.B context folder get
+Get a folder from a collection
+
+.SS "context folder get"
+Get a folder from a collection
+
+.B Usage:
+[options]
+
+.B Options:
+.TP
+.B \-\-folder\-id <id>
+Folder ID
+.TP
+.B \-c, \-\-collection\-id <id>
+Collection ID
+
+.SS "context response"
+Response commands
+
+.B Usage:
+[options] [command]
+
+.B Subcommands:
+.TP
+.B context response get
+Get a saved response example from a collection
+
+.SS "context response get"
+Get a saved response example from a collection
+
+.B Usage:
+[options]
+
+.B Options:
+.TP
+.B \-\-id <id>
+Response ID
+.TP
+.B \-c, \-\-collection\-id <id>
+Collection ID
+.TP
+.B \-r, \-\-request\-id <id>
+Request ID
+
+.SS "context workspace"
+Workspace commands
+
+.B Usage:
+[options] [command]
+
+.B Subcommands:
+.TP
+.B context workspace get
+Get a workspace by ID
+
+.SS "context workspace get"
+Get a workspace by ID
+
+.B Usage:
+[options]
+
+.B Options:
+.TP
+.B \-w, \-\-workspace\-id <id>
+Workspace ID
+
+.SS "context environment"
+Environment commands
+
+.B Usage:
+[options] [command]
+
+.B Subcommands:
+.TP
+.B context environment get
+Get a single environment by ID
+
+.SS "context environment get"
+Get a single environment by ID
+
+.B Usage:
+[options]
+
+.B Options:
+.TP
+.B \-e, \-\-environment\-id <id>
+Environment ID
+
 .SS "search"
 Search for Postman element types (requests, collections, workspaces, and more).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postman-cli",
-  "version": "1.37.0",
+  "version": "1.38.1",
   "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.37.0",
-    "@postman/pm-bin-macos-x64": "1.37.0",
-    "@postman/pm-bin-linux-x64": "1.37.0",
-    "@postman/pm-bin-linux-arm64": "1.37.0",
-    "@postman/pm-bin-windows-x64": "1.37.0"
+    "@postman/pm-bin-macos-arm64": "1.38.1",
+    "@postman/pm-bin-macos-x64": "1.38.1",
+    "@postman/pm-bin-linux-x64": "1.38.1",
+    "@postman/pm-bin-linux-arm64": "1.38.1",
+    "@postman/pm-bin-windows-x64": "1.38.1"
   }
 }