From d18d972e88c1a03890fcbe3ba2f0dbffb06f5e48 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 25 Mar 2026 02:05:13 +0000
Subject: [PATCH 01/19] chore(ci): skip lint on metadata-only changes

Note that we still want to run tests, as these depend on the metadata.
---
 .github/workflows/ci.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 2742613..940785a 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -22,7 +22,7 @@ jobs:
     timeout-minutes: 10
     name: lint
     runs-on: ${{ github.repository == 'stainless-sdks/beeper-desktop-api-cli' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
-    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
+    if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
 
     steps:
       - uses: actions/checkout@v6
@@ -49,7 +49,7 @@ jobs:
       contents: read
       id-token: write
     runs-on: ${{ github.repository == 'stainless-sdks/beeper-desktop-api-cli' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
-    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
+    if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
     steps:
       - uses: actions/checkout@v6
 

From c7c519cf80adffc7cebbd3ec220227baf48672d7 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 25 Mar 2026 02:06:05 +0000
Subject: [PATCH 02/19] chore(tests): bump steady to v0.19.7

---
 scripts/mock | 6 +++---
 scripts/test | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/scripts/mock b/scripts/mock
index 0f82c95..3732f8e 100755
--- a/scripts/mock
+++ b/scripts/mock
@@ -22,9 +22,9 @@ echo "==> Starting mock server with URL ${URL}"
 # Run steady mock on the given spec
 if [ "$1" == "--daemon" ]; then
   # Pre-install the package so the download doesn't eat into the startup timeout
-  npm exec --package=@stdy/cli@0.19.6 -- steady --version
+  npm exec --package=@stdy/cli@0.19.7 -- steady --version
 
-  npm exec --package=@stdy/cli@0.19.6 -- steady --host 127.0.0.1 -p 4010 --validator-form-array-format=repeat --validator-query-array-format=repeat --validator-form-object-format=brackets --validator-query-object-format=brackets "$URL" &> .stdy.log &
+  npm exec --package=@stdy/cli@0.19.7 -- steady --host 127.0.0.1 -p 4010 --validator-form-array-format=repeat --validator-query-array-format=repeat --validator-form-object-format=brackets --validator-query-object-format=brackets "$URL" &> .stdy.log &
 
   # Wait for server to come online via health endpoint (max 30s)
   echo -n "Waiting for server"
@@ -48,5 +48,5 @@ if [ "$1" == "--daemon" ]; then
 
   echo
 else
-  npm exec --package=@stdy/cli@0.19.6 -- steady --host 127.0.0.1 -p 4010 --validator-form-array-format=repeat --validator-query-array-format=repeat --validator-form-object-format=brackets --validator-query-object-format=brackets "$URL"
+  npm exec --package=@stdy/cli@0.19.7 -- steady --host 127.0.0.1 -p 4010 --validator-form-array-format=repeat --validator-query-array-format=repeat --validator-form-object-format=brackets --validator-query-object-format=brackets "$URL"
 fi
diff --git a/scripts/test b/scripts/test
index 9f448ce..0a858e6 100755
--- a/scripts/test
+++ b/scripts/test
@@ -46,7 +46,7 @@ elif ! steady_is_running ; then
   echo -e "To run the server, pass in the path or url of your OpenAPI"
   echo -e "spec to the steady command:"
   echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.19.6 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-form-array-format=repeat --validator-query-array-format=repeat --validator-form-object-format=brackets --validator-query-object-format=brackets${NC}"
+  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.19.7 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-form-array-format=repeat --validator-query-array-format=repeat --validator-form-object-format=brackets --validator-query-object-format=brackets${NC}"
   echo
 
   exit 1

From 03e1c530c7c6e0988d6f9f95a4f115dc178d7463 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 25 Mar 2026 02:25:05 +0000
Subject: [PATCH 03/19] codegen metadata

---
 .stats.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.stats.yml b/.stats.yml
index 2b39be6..60bb453 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 23
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/beeper%2Fbeeper-desktop-api-5a8ac7b545c48dc892e5c680303e305254921554dabee848e40a808659dbcf1e.yml
 openapi_spec_hash: 0103975601aac1445d3a4ef418c5d17a
-config_hash: ca148af6be59ec54295b2c5f852a38d1
+config_hash: e342a96262eaf44c54e8bbb93cc8d7a7

From 8ccee5cbcc06978fef3c96a220d18eaae98bd49a Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 25 Mar 2026 02:25:23 +0000
Subject: [PATCH 04/19] codegen metadata

---
 .stats.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.stats.yml b/.stats.yml
index 60bb453..16d5bba 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 23
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/beeper%2Fbeeper-desktop-api-5a8ac7b545c48dc892e5c680303e305254921554dabee848e40a808659dbcf1e.yml
 openapi_spec_hash: 0103975601aac1445d3a4ef418c5d17a
-config_hash: e342a96262eaf44c54e8bbb93cc8d7a7
+config_hash: f99f904573839260bdb6d428bad17613

From 42310f51c4a4a7de7562f5d79b87bdf6cc33fb8f Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 25 Mar 2026 02:25:34 +0000
Subject: [PATCH 05/19] codegen metadata

---
 .stats.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.stats.yml b/.stats.yml
index 16d5bba..2c47924 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 23
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/beeper%2Fbeeper-desktop-api-5a8ac7b545c48dc892e5c680303e305254921554dabee848e40a808659dbcf1e.yml
 openapi_spec_hash: 0103975601aac1445d3a4ef418c5d17a
-config_hash: f99f904573839260bdb6d428bad17613
+config_hash: 7d85c0b454fc78a59db6474c5c4d73c6

From c332ed822bc6e94cb521620032bdcf941d4b7593 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 27 Mar 2026 02:07:21 +0000
Subject: [PATCH 06/19] feat: set CLI flag constant values automatically where
 `x-stainless-const` is set

---
 internal/requestflag/requestflag.go | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/internal/requestflag/requestflag.go b/internal/requestflag/requestflag.go
index 21a8a69..32c13f5 100644
--- a/internal/requestflag/requestflag.go
+++ b/internal/requestflag/requestflag.go
@@ -37,6 +37,12 @@ type Flag[
 	BodyPath   string // location in the request body to put this flag's value
 	BodyRoot   bool   // if true, then use this value as the entire request body
 
+	// Const, when true, marks this flag as a constant. The flag's Default value is used as the fixed value
+	// and always included in the request (IsSet returns true). The user can still see and override the flag,
+	// but isn't required to provide it. This is used for single-value enums and `x-stainless-const`
+	// parameters.
+	Const bool
+
 	// unexported fields for internal use
 	count      int       // number of times the flag has been set
 	hasBeenSet bool      // whether the flag has been set from env or file
@@ -229,7 +235,7 @@ func (f *Flag[T]) String() string {
 }
 
 func (f *Flag[T]) IsSet() bool {
-	return f.hasBeenSet
+	return f.hasBeenSet || f.Const
 }
 
 func (f *Flag[T]) Names() []string {
@@ -255,6 +261,10 @@ func (f *Flag[T]) SetCategory(c string) {
 var _ cli.RequiredFlag = (*Flag[any])(nil) // Type assertion to ensure interface compliance
 
 func (f *Flag[T]) IsRequired() bool {
+	// Const flags are always auto-set, so never required from the user.
+	if f.Const {
+		return false
+	}
 	// Intentionally don't use `f.Required`, because request flags may be passed
 	// over stdin as well as by flag.
 	if f.BodyPath != "" || f.BodyRoot {
@@ -268,6 +278,10 @@ type RequiredFlagOrStdin interface {
 }
 
 func (f *Flag[T]) IsRequiredAsFlagOrStdin() bool {
+	// Const flags are always auto-set, so never required from the user.
+	if f.Const {
+		return false
+	}
 	return f.Required
 }
 

From 8b749cf09b595e66687d4030cee0791aff7e14c4 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 27 Mar 2026 02:08:12 +0000
Subject: [PATCH 07/19] chore: omit full usage information when missing
 required CLI parameters

---
 pkg/cmd/flagoptions.go | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/pkg/cmd/flagoptions.go b/pkg/cmd/flagoptions.go
index 4a39cd0..f74e11e 100644
--- a/pkg/cmd/flagoptions.go
+++ b/pkg/cmd/flagoptions.go
@@ -246,17 +246,15 @@ func flagOptions(
 	}
 
 	if missingFlags := requestflag.GetMissingRequiredFlags(cmd, requestContents.Body); len(missingFlags) > 0 {
-		var buf bytes.Buffer
-		cli.HelpPrinter(&buf, cli.SubcommandHelpTemplate, cmd)
-		usage := buf.String()
 		if len(missingFlags) == 1 {
-			return nil, fmt.Errorf("%sRequired flag %q not set", usage, missingFlags[0].Names()[0])
+			return nil, fmt.Errorf("Required flag %q not set\nRun '%s --help' for usage information", missingFlags[0].Names()[0], cmd.FullName())
+
 		} else {
 			names := []string{}
 			for _, flag := range missingFlags {
 				names = append(names, flag.Names()[0])
 			}
-			return nil, fmt.Errorf("%sRequired flags %q not set", usage, strings.Join(names, ", "))
+			return nil, fmt.Errorf("Required flags %q not set\nRun '%s --help' for usage information", strings.Join(names, ", "), cmd.FullName())
 		}
 	}
 

From 180bf353b36de3cfee9e9497dca4558622654e18 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 27 Mar 2026 02:09:39 +0000
Subject: [PATCH 08/19] chore(internal): update multipart form array
 serialization

---
 scripts/mock | 4 ++--
 scripts/test | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/scripts/mock b/scripts/mock
index 3732f8e..58e4628 100755
--- a/scripts/mock
+++ b/scripts/mock
@@ -24,7 +24,7 @@ if [ "$1" == "--daemon" ]; then
   # Pre-install the package so the download doesn't eat into the startup timeout
   npm exec --package=@stdy/cli@0.19.7 -- steady --version
 
-  npm exec --package=@stdy/cli@0.19.7 -- steady --host 127.0.0.1 -p 4010 --validator-form-array-format=repeat --validator-query-array-format=repeat --validator-form-object-format=brackets --validator-query-object-format=brackets "$URL" &> .stdy.log &
+  npm exec --package=@stdy/cli@0.19.7 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=repeat --validator-form-array-format=repeat --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL" &> .stdy.log &
 
   # Wait for server to come online via health endpoint (max 30s)
   echo -n "Waiting for server"
@@ -48,5 +48,5 @@ if [ "$1" == "--daemon" ]; then
 
   echo
 else
-  npm exec --package=@stdy/cli@0.19.7 -- steady --host 127.0.0.1 -p 4010 --validator-form-array-format=repeat --validator-query-array-format=repeat --validator-form-object-format=brackets --validator-query-object-format=brackets "$URL"
+  npm exec --package=@stdy/cli@0.19.7 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=repeat --validator-form-array-format=repeat --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL"
 fi
diff --git a/scripts/test b/scripts/test
index 0a858e6..79ceebe 100755
--- a/scripts/test
+++ b/scripts/test
@@ -46,7 +46,7 @@ elif ! steady_is_running ; then
   echo -e "To run the server, pass in the path or url of your OpenAPI"
   echo -e "spec to the steady command:"
   echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.19.7 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-form-array-format=repeat --validator-query-array-format=repeat --validator-form-object-format=brackets --validator-query-object-format=brackets${NC}"
+  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.19.7 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-query-array-format=repeat --validator-form-array-format=repeat --validator-query-object-format=brackets --validator-form-object-format=brackets${NC}"
   echo
 
   exit 1

From 16566c5d80a77de14f33e1895ec72cfa89da99c7 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 28 Mar 2026 02:21:33 +0000
Subject: [PATCH 09/19] fix: fix for off-by-one error in pagination logic

---
 pkg/cmd/cmdutil.go | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/pkg/cmd/cmdutil.go b/pkg/cmd/cmdutil.go
index 9b24177..cb8183c 100644
--- a/pkg/cmd/cmdutil.go
+++ b/pkg/cmd/cmdutil.go
@@ -378,6 +378,7 @@ type HasRawJSON interface {
 
 // For an iterator over different value types, display its values to the user in
 // different formats.
+// -1 is used to signal no limit of items to display
 func ShowJSONIterator[T any](stdout *os.File, title string, iter jsonview.Iterator[T], format string, transform string, itemsToDisplay int64) error {
 	if format == "explore" {
 		return jsonview.ExploreJSONStream(title, iter)
@@ -393,10 +394,8 @@ func ShowJSONIterator[T any](stdout *os.File, title string, iter jsonview.Iterat
 	usePager := false
 	output := []byte{}
 	numberOfNewlines := 0
-	for iter.Next() {
-		if itemsToDisplay == 0 {
-			break
-		}
+	// -1 is used to signal no limit of items to display
+	for itemsToDisplay != 0 && iter.Next() {
 		item := iter.Current()
 		var obj gjson.Result
 		if hasRaw, ok := any(item).(HasRawJSON); ok {

From 533501d2960fc565d5891d5f610a7feef458d0b2 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 1 Apr 2026 02:18:01 +0000
Subject: [PATCH 10/19] chore(tests): bump steady to v0.20.1

---
 scripts/mock | 6 +++---
 scripts/test | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/scripts/mock b/scripts/mock
index 58e4628..5ea72a2 100755
--- a/scripts/mock
+++ b/scripts/mock
@@ -22,9 +22,9 @@ echo "==> Starting mock server with URL ${URL}"
 # Run steady mock on the given spec
 if [ "$1" == "--daemon" ]; then
   # Pre-install the package so the download doesn't eat into the startup timeout
-  npm exec --package=@stdy/cli@0.19.7 -- steady --version
+  npm exec --package=@stdy/cli@0.20.1 -- steady --version
 
-  npm exec --package=@stdy/cli@0.19.7 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=repeat --validator-form-array-format=repeat --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL" &> .stdy.log &
+  npm exec --package=@stdy/cli@0.20.1 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=repeat --validator-form-array-format=repeat --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL" &> .stdy.log &
 
   # Wait for server to come online via health endpoint (max 30s)
   echo -n "Waiting for server"
@@ -48,5 +48,5 @@ if [ "$1" == "--daemon" ]; then
 
   echo
 else
-  npm exec --package=@stdy/cli@0.19.7 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=repeat --validator-form-array-format=repeat --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL"
+  npm exec --package=@stdy/cli@0.20.1 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=repeat --validator-form-array-format=repeat --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL"
 fi
diff --git a/scripts/test b/scripts/test
index 79ceebe..17f4857 100755
--- a/scripts/test
+++ b/scripts/test
@@ -46,7 +46,7 @@ elif ! steady_is_running ; then
   echo -e "To run the server, pass in the path or url of your OpenAPI"
   echo -e "spec to the steady command:"
   echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.19.7 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-query-array-format=repeat --validator-form-array-format=repeat --validator-query-object-format=brackets --validator-form-object-format=brackets${NC}"
+  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.20.1 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-query-array-format=repeat --validator-form-array-format=repeat --validator-query-object-format=brackets --validator-form-object-format=brackets${NC}"
   echo
 
   exit 1

From 3a7b085b2130d21ee0a2b434dbaa3efada1e1bb3 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 1 Apr 2026 02:22:27 +0000
Subject: [PATCH 11/19] chore(tests): bump steady to v0.20.2

---
 scripts/mock | 6 +++---
 scripts/test | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/scripts/mock b/scripts/mock
index 5ea72a2..7c58865 100755
--- a/scripts/mock
+++ b/scripts/mock
@@ -22,9 +22,9 @@ echo "==> Starting mock server with URL ${URL}"
 # Run steady mock on the given spec
 if [ "$1" == "--daemon" ]; then
   # Pre-install the package so the download doesn't eat into the startup timeout
-  npm exec --package=@stdy/cli@0.20.1 -- steady --version
+  npm exec --package=@stdy/cli@0.20.2 -- steady --version
 
-  npm exec --package=@stdy/cli@0.20.1 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=repeat --validator-form-array-format=repeat --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL" &> .stdy.log &
+  npm exec --package=@stdy/cli@0.20.2 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=repeat --validator-form-array-format=repeat --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL" &> .stdy.log &
 
   # Wait for server to come online via health endpoint (max 30s)
   echo -n "Waiting for server"
@@ -48,5 +48,5 @@ if [ "$1" == "--daemon" ]; then
 
   echo
 else
-  npm exec --package=@stdy/cli@0.20.1 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=repeat --validator-form-array-format=repeat --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL"
+  npm exec --package=@stdy/cli@0.20.2 -- steady --host 127.0.0.1 -p 4010 --validator-query-array-format=repeat --validator-form-array-format=repeat --validator-query-object-format=brackets --validator-form-object-format=brackets "$URL"
 fi
diff --git a/scripts/test b/scripts/test
index 17f4857..7ba4b3f 100755
--- a/scripts/test
+++ b/scripts/test
@@ -46,7 +46,7 @@ elif ! steady_is_running ; then
   echo -e "To run the server, pass in the path or url of your OpenAPI"
   echo -e "spec to the steady command:"
   echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.20.1 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-query-array-format=repeat --validator-form-array-format=repeat --validator-query-object-format=brackets --validator-form-object-format=brackets${NC}"
+  echo -e "  \$ ${YELLOW}npm exec --package=@stdy/cli@0.20.2 -- steady path/to/your.openapi.yml --host 127.0.0.1 -p 4010 --validator-query-array-format=repeat --validator-form-array-format=repeat --validator-query-object-format=brackets --validator-form-object-format=brackets${NC}"
   echo
 
   exit 1

From 6df00248f562bbbd98e7cbccf8ddd82b35a40ae3 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 2 Apr 2026 02:09:40 +0000
Subject: [PATCH 12/19] fix: handle empty data set using `--format explore`

---
 internal/jsonview/explorer.go      |  4 ++++
 internal/jsonview/explorer_test.go | 37 ++++++++++++++++++++++++++++++
 2 files changed, 41 insertions(+)
 create mode 100644 internal/jsonview/explorer_test.go

diff --git a/internal/jsonview/explorer.go b/internal/jsonview/explorer.go
index 055541e..ea900bc 100644
--- a/internal/jsonview/explorer.go
+++ b/internal/jsonview/explorer.go
@@ -406,6 +406,10 @@ func (v *JSONViewer) navigateForward() (tea.Model, tea.Cmd) {
 		return v, nil
 	}
 
+	if len(tableView.rowData) < 1 {
+		return v, nil
+	}
+
 	cursor := tableView.table.Cursor()
 	selected := tableView.rowData[cursor]
 	if !v.canNavigateInto(selected) {
diff --git a/internal/jsonview/explorer_test.go b/internal/jsonview/explorer_test.go
new file mode 100644
index 0000000..3f0e751
--- /dev/null
+++ b/internal/jsonview/explorer_test.go
@@ -0,0 +1,37 @@
+package jsonview
+
+import (
+	"testing"
+
+	"github.com/charmbracelet/bubbles/help"
+	"github.com/tidwall/gjson"
+)
+
+func TestNavigateForward_EmptyRowData(t *testing.T) {
+	// An empty JSON array produces a TableView with no rows.
+	emptyArray := gjson.Parse("[]")
+	view, err := newTableView("", emptyArray, false)
+	if err != nil {
+		t.Fatalf("newTableView: %v", err)
+	}
+
+	viewer := &JSONViewer{
+		stack: []JSONView{view},
+		root:  "test",
+		help:  help.New(),
+	}
+
+	// Should return without panicking despite the empty data set.
+	model, cmd := viewer.navigateForward()
+	if model != viewer {
+		t.Error("expected same viewer model returned")
+	}
+	if cmd != nil {
+		t.Error("expected nil cmd")
+	}
+
+	// Stack should remain unchanged (no new view pushed).
+	if len(viewer.stack) != 1 {
+		t.Errorf("expected stack length 1, got %d", len(viewer.stack))
+	}
+}

From 4af189dc0e5add5c654204e0e90c91e199de479a Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 2 Apr 2026 02:09:55 +0000
Subject: [PATCH 13/19] fix: use `RawJSON` when iterating items with `--format
 explore` in the CLI

---
 internal/jsonview/explorer.go      | 34 ++++++++++++++++++++--
 internal/jsonview/explorer_test.go | 45 ++++++++++++++++++++++--------
 pkg/cmd/cmdutil.go                 |  6 ++--
 3 files changed, 68 insertions(+), 17 deletions(-)

diff --git a/internal/jsonview/explorer.go b/internal/jsonview/explorer.go
index ea900bc..836bb2c 100644
--- a/internal/jsonview/explorer.go
+++ b/internal/jsonview/explorer.go
@@ -1,6 +1,7 @@
 package jsonview
 
 import (
+	"bytes"
 	"encoding/json"
 	"errors"
 	"fmt"
@@ -309,6 +310,10 @@ func ExploreJSON(title string, json gjson.Result) error {
 	return err
 }
 
+type hasRawJSON interface {
+	RawJSON() string
+}
+
 // ExploreJSONStream explores JSON data loaded incrementally via an iterator
 func ExploreJSONStream[T any](title string, it Iterator[T]) error {
 	anyIt := genericToAnyIterator(it)
@@ -327,12 +332,12 @@ func ExploreJSONStream[T any](title string, it Iterator[T]) error {
 		return err
 	}
 
-	// Convert items to JSON array
-	jsonBytes, err := json.Marshal(items)
+	arrayJSONBytes, err := marshalItemsToJSONArray(items)
 	if err != nil {
 		return err
 	}
-	arrayJSON := gjson.ParseBytes(jsonBytes)
+
+	arrayJSON := gjson.ParseBytes(arrayJSONBytes)
 	view, err := newTableView("", arrayJSON, false)
 	if err != nil {
 		return err
@@ -352,6 +357,29 @@ func ExploreJSONStream[T any](title string, it Iterator[T]) error {
 	return err
 }
 
+func marshalItemsToJSONArray(items []any) ([]byte, error) {
+	var buf bytes.Buffer
+	buf.WriteByte('[')
+
+	for i, item := range items {
+		if i > 0 {
+			buf.WriteByte(',')
+		}
+		if hasRaw, ok := item.(hasRawJSON); ok {
+			buf.WriteString(hasRaw.RawJSON())
+		} else {
+			jsonData, err := json.Marshal(item)
+			if err != nil {
+				return nil, err
+			}
+			buf.Write(jsonData)
+		}
+	}
+
+	buf.WriteByte(']')
+	return buf.Bytes(), nil
+}
+
 func (v *JSONViewer) current() JSONView { return v.stack[len(v.stack)-1] }
 func (v *JSONViewer) Init() tea.Cmd     { return nil }
 
diff --git a/internal/jsonview/explorer_test.go b/internal/jsonview/explorer_test.go
index 3f0e751..c559254 100644
--- a/internal/jsonview/explorer_test.go
+++ b/internal/jsonview/explorer_test.go
@@ -5,15 +5,15 @@ import (
 
 	"github.com/charmbracelet/bubbles/help"
 	"github.com/tidwall/gjson"
+
+	"github.com/stretchr/testify/require"
 )
 
 func TestNavigateForward_EmptyRowData(t *testing.T) {
 	// An empty JSON array produces a TableView with no rows.
 	emptyArray := gjson.Parse("[]")
 	view, err := newTableView("", emptyArray, false)
-	if err != nil {
-		t.Fatalf("newTableView: %v", err)
-	}
+	require.NoError(t, err)
 
 	viewer := &JSONViewer{
 		stack: []JSONView{view},
@@ -23,15 +23,38 @@ func TestNavigateForward_EmptyRowData(t *testing.T) {
 
 	// Should return without panicking despite the empty data set.
 	model, cmd := viewer.navigateForward()
-	if model != viewer {
-		t.Error("expected same viewer model returned")
-	}
-	if cmd != nil {
-		t.Error("expected nil cmd")
-	}
+	require.Equal(t, model, viewer, "expected same viewer model returned")
+	require.Nil(t, cmd)
 
 	// Stack should remain unchanged (no new view pushed).
-	if len(viewer.stack) != 1 {
-		t.Errorf("expected stack length 1, got %d", len(viewer.stack))
+	require.Equal(t, 1, len(viewer.stack), "expected stack length 1, got %d", len(viewer.stack))
+}
+
+// rawJSONItem implements HasRawJSON, returning pre-built JSON.
+type rawJSONItem struct {
+	raw string
+}
+
+func (r rawJSONItem) RawJSON() string { return r.raw }
+
+func TestMarshalItemsToJSONArray_WithHasRawJSON(t *testing.T) {
+	items := []any{
+		rawJSONItem{raw: `{"id":1,"name":"alice"}`},
+		rawJSONItem{raw: `{"id":2,"name":"bob"}`},
 	}
+
+	got, err := marshalItemsToJSONArray(items)
+	require.NoError(t, err)
+	require.JSONEq(t, `[{"id":1,"name":"alice"},{"id":2,"name":"bob"}]`, string(got))
+}
+
+func TestMarshalItemsToJSONArray_WithoutHasRawJSON(t *testing.T) {
+	items := []any{
+		map[string]any{"id": 1, "name": "alice"},
+		map[string]any{"id": 2, "name": "bob"},
+	}
+
+	got, err := marshalItemsToJSONArray(items)
+	require.NoError(t, err)
+	require.JSONEq(t, `[{"id":1,"name":"alice"},{"id":2,"name":"bob"}]`, string(got))
 }
diff --git a/pkg/cmd/cmdutil.go b/pkg/cmd/cmdutil.go
index cb8183c..82655ad 100644
--- a/pkg/cmd/cmdutil.go
+++ b/pkg/cmd/cmdutil.go
@@ -372,7 +372,7 @@ func countTerminalLines(data []byte, terminalWidth int) int {
 	return bytes.Count([]byte(wrap.String(string(data), terminalWidth)), []byte("\n"))
 }
 
-type HasRawJSON interface {
+type hasRawJSON interface {
 	RawJSON() string
 }
 
@@ -398,7 +398,7 @@ func ShowJSONIterator[T any](stdout *os.File, title string, iter jsonview.Iterat
 	for itemsToDisplay != 0 && iter.Next() {
 		item := iter.Current()
 		var obj gjson.Result
-		if hasRaw, ok := any(item).(HasRawJSON); ok {
+		if hasRaw, ok := any(item).(hasRawJSON); ok {
 			obj = gjson.Parse(hasRaw.RawJSON())
 		} else {
 			jsonData, err := json.Marshal(item)
@@ -445,7 +445,7 @@ func ShowJSONIterator[T any](stdout *os.File, title string, iter jsonview.Iterat
 			}
 			item := iter.Current()
 			var obj gjson.Result
-			if hasRaw, ok := any(item).(HasRawJSON); ok {
+			if hasRaw, ok := any(item).(hasRawJSON); ok {
 				obj = gjson.Parse(hasRaw.RawJSON())
 			} else {
 				jsonData, err := json.Marshal(item)

From ed64986c234a83e6c875a1202a7c217df9efa206 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 3 Apr 2026 02:10:33 +0000
Subject: [PATCH 14/19] feat: binary-only parameters become CLI flags that take
 filenames only

---
 internal/requestflag/requestflag.go | 10 +++
 pkg/cmd/asset.go                    |  9 +--
 pkg/cmd/asset_test.go               | 10 ++-
 pkg/cmd/flagoptions.go              | 96 +++++++++++++++++++++++++++++
 4 files changed, 118 insertions(+), 7 deletions(-)

diff --git a/internal/requestflag/requestflag.go b/internal/requestflag/requestflag.go
index 32c13f5..bdef64f 100644
--- a/internal/requestflag/requestflag.go
+++ b/internal/requestflag/requestflag.go
@@ -43,6 +43,11 @@ type Flag[
 	// parameters.
 	Const bool
 
+	// FileInput, when true, indicates that the flag value is always treated as a file path. The file is read
+	// automatically without requiring the "@" prefix. This is used for parameters with `type: string, format:
+	// binary` in the OpenAPI spec.
+	FileInput bool
+
 	// unexported fields for internal use
 	count      int       // number of times the flag has been set
 	hasBeenSet bool      // whether the flag has been set from env or file
@@ -59,6 +64,7 @@ type InRequest interface {
 	GetHeaderPath() string
 	GetBodyPath() string
 	IsBodyRoot() bool
+	IsFileInput() bool
 }
 
 func (f Flag[T]) GetQueryPath() string {
@@ -77,6 +83,10 @@ func (f Flag[T]) IsBodyRoot() bool {
 	return f.BodyRoot
 }
 
+func (f Flag[T]) IsFileInput() bool {
+	return f.FileInput
+}
+
 // The values that will be sent in different parts of a request.
 type RequestContents struct {
 	Queries map[string]any
diff --git a/pkg/cmd/asset.go b/pkg/cmd/asset.go
index d7fc779..65023e3 100644
--- a/pkg/cmd/asset.go
+++ b/pkg/cmd/asset.go
@@ -53,10 +53,11 @@ var assetsUpload = cli.Command{
 	Suggest: true,
 	Flags: []cli.Flag{
 		&requestflag.Flag[string]{
-			Name:     "file",
-			Usage:    "The file to upload (max 500 MB).",
-			Required: true,
-			BodyPath: "file",
+			Name:      "file",
+			Usage:     "The file to upload (max 500 MB).",
+			Required:  true,
+			BodyPath:  "file",
+			FileInput: true,
 		},
 		&requestflag.Flag[string]{
 			Name:     "file-name",
diff --git a/pkg/cmd/asset_test.go b/pkg/cmd/asset_test.go
index 2ce574c..696660a 100644
--- a/pkg/cmd/asset_test.go
+++ b/pkg/cmd/asset_test.go
@@ -3,6 +3,7 @@
 package cmd
 
 import (
+	"strings"
 	"testing"
 
 	"github.com/beeper/desktop-api-cli/internal/mocktest"
@@ -46,18 +47,21 @@ func TestAssetsUpload(t *testing.T) {
 			t,
 			"--access-token", "string",
 			"assets", "upload",
-			"--file", "Example data",
+			"--file", mocktest.TestFile(t, "Example data"),
 			"--file-name", "fileName",
 			"--mime-type", "mimeType",
 		)
 	})
 
 	t.Run("piping data", func(t *testing.T) {
+		testFile := mocktest.TestFile(t, "Example data")
 		// Test piping YAML data over stdin
-		pipeData := []byte("" +
+		pipeDataStr := "" +
 			"file: Example data\n" +
 			"fileName: fileName\n" +
-			"mimeType: mimeType\n")
+			"mimeType: mimeType\n"
+		pipeDataStr = strings.ReplaceAll(pipeDataStr, "Example data", testFile)
+		pipeData := []byte(pipeDataStr)
 		mocktest.TestRunMockTestWithPipeAndFlags(
 			t, pipeData,
 			"--access-token", "string",
diff --git a/pkg/cmd/flagoptions.go b/pkg/cmd/flagoptions.go
index f74e11e..24ed79a 100644
--- a/pkg/cmd/flagoptions.go
+++ b/pkg/cmd/flagoptions.go
@@ -98,6 +98,21 @@ func embedFilesValue(v reflect.Value, embedStyle FileEmbedStyle) (reflect.Value,
 		return result, nil
 
 	case reflect.String:
+		// FilePathValue is always treated as a file path without needing the "@" prefix.
+		// These only appear on binary upload parameters (multipart/octet-stream), which
+		// always use EmbedIOReader.
+		if v.Type() == reflect.TypeOf(FilePathValue("")) {
+			s := v.String()
+			if s == "" {
+				return v, nil
+			}
+			content, err := os.ReadFile(s)
+			if err != nil {
+				return v, err
+			}
+			return reflect.ValueOf(string(content)), nil
+		}
+
 		s := v.String()
 		if literal, ok := strings.CutPrefix(s, "\\@"); ok {
 			// Allow for escaped @ signs if you don't want them to be treated as files
@@ -258,6 +273,12 @@ func flagOptions(
 		}
 	}
 
+	// For flags marked as FileInput (type: string, format: binary), the value is always
+	// a file path. Wrap with FilePathValue so embedFiles reads the file automatically
+	// without requiring the user to type the "@" prefix. This handles both values set
+	// via explicit CLI flags and values that arrived via piped YAML/JSON data.
+	wrapFileInputValues(cmd, &requestContents)
+
 	// Embed files passed as "@file.jpg" in the request body, headers, and query:
 	embedStyle := EmbedText
 	if bodyType == ApplicationOctetStream || bodyType == MultipartFormEncoded {
@@ -371,3 +392,78 @@ func flagOptions(
 
 	return options, nil
 }
+
+// FilePathValue is a string wrapper that marks a value as a file path whose contents should be read
+// and embedded in the request. Unlike a regular string, embedFilesValue always treats a FilePathValue
+// as a file path without needing the "@" prefix.
+type FilePathValue string
+
+// wrapFileInputValues replaces string values for FileInput flags (type: string, format: binary) with
+// FilePathValue sentinel values. embedFilesValue recognizes FilePathValue and reads the file contents
+// directly, so the user doesn't need to type the "@" prefix. This handles both values set via explicit
+// CLI flags and values that arrived via piped YAML/JSON data.
+func wrapFileInputValues(cmd *cli.Command, contents *requestflag.RequestContents) {
+	bodyMap, _ := contents.Body.(map[string]any)
+
+	for _, flag := range cmd.Flags {
+		inReq, ok := flag.(requestflag.InRequest)
+		if !ok || !inReq.IsFileInput() || inReq.IsBodyRoot() {
+			continue
+		}
+
+		// Wrap values set via explicit CLI flags.
+		if flag.IsSet() {
+			if wrapped, changed := wrapFileInputValue(flag.Get()); changed {
+				if bodyPath := inReq.GetBodyPath(); bodyPath != "" {
+					if bodyMap != nil {
+						bodyMap[bodyPath] = wrapped
+					}
+				} else if queryPath := inReq.GetQueryPath(); queryPath != "" {
+					contents.Queries[queryPath] = wrapped
+				} else if headerPath := inReq.GetHeaderPath(); headerPath != "" {
+					contents.Headers[headerPath] = wrapped
+				}
+			}
+		}
+
+		// Wrap values that arrived via piped YAML/JSON data in the body map.
+		if bodyPath := inReq.GetBodyPath(); bodyPath != "" && bodyMap != nil {
+			if value, exists := bodyMap[bodyPath]; exists {
+				if wrapped, changed := wrapFileInputValue(value); changed {
+					bodyMap[bodyPath] = wrapped
+				}
+			}
+		}
+	}
+}
+
+func wrapFileInputValue(value any) (any, bool) {
+	switch v := value.(type) {
+	case string:
+		if v == "" {
+			return value, false
+		}
+		return FilePathValue(v), true
+
+	case []string:
+		result := make([]any, len(v))
+		for i, s := range v {
+			result[i] = FilePathValue(s)
+		}
+		return result, true
+
+	case []any:
+		result := make([]any, len(v))
+		for i, elem := range v {
+			if s, ok := elem.(string); ok {
+				result[i] = FilePathValue(s)
+			} else {
+				result[i] = elem
+			}
+		}
+		return result, true
+
+	default:
+		return value, false
+	}
+}

From 8d976d441c86ddfaa67c8fad50a156f9374e0d16 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 3 Apr 2026 02:11:17 +0000
Subject: [PATCH 15/19] feat: better error message if scheme forgotten in CLI
 `*_BASE_URL`/`--base-url`

---
 cmd/beeper-desktop-cli/main.go |  7 ++++++
 pkg/cmd/cmd.go                 |  3 +++
 pkg/cmd/cmdutil.go             |  9 ++++++++
 pkg/cmd/cmdutil_test.go        | 39 ++++++++++++++++++++++++++++++++++
 4 files changed, 58 insertions(+)

diff --git a/cmd/beeper-desktop-cli/main.go b/cmd/beeper-desktop-cli/main.go
index e27225a..8ac76ad 100644
--- a/cmd/beeper-desktop-cli/main.go
+++ b/cmd/beeper-desktop-cli/main.go
@@ -23,6 +23,13 @@ func main() {
 		prepareForAutocomplete(app)
 	}
 
+	if baseURL, ok := os.LookupEnv("BEEPER_DESKTOP_BASE_URL"); ok {
+		if err := cmd.ValidateBaseURL(baseURL, "BEEPER_DESKTOP_BASE_URL"); err != nil {
+			fmt.Fprintf(os.Stderr, "%s\n", err.Error())
+			os.Exit(1)
+		}
+	}
+
 	if err := app.Run(context.Background(), os.Args); err != nil {
 		exitCode := 1
 
diff --git a/pkg/cmd/cmd.go b/pkg/cmd/cmd.go
index 3351e7f..4c91ac7 100644
--- a/pkg/cmd/cmd.go
+++ b/pkg/cmd/cmd.go
@@ -39,6 +39,9 @@ func init() {
 				Name:        "base-url",
 				DefaultText: "url",
 				Usage:       "Override the base URL for API requests",
+				Validator: func(baseURL string) error {
+					return ValidateBaseURL(baseURL, "--base-url")
+				},
 			},
 			&cli.StringFlag{
 				Name:  "format",
diff --git a/pkg/cmd/cmdutil.go b/pkg/cmd/cmdutil.go
index 82655ad..06531f3 100644
--- a/pkg/cmd/cmdutil.go
+++ b/pkg/cmd/cmdutil.go
@@ -29,6 +29,15 @@ import (
 
 var OutputFormats = []string{"auto", "explore", "json", "jsonl", "pretty", "raw", "yaml"}
 
+// ValidateBaseURL checks that a base URL is correctly prefixed with a protocol scheme and produces a better
+// error message than the person would see otherwise if it doesn't.
+func ValidateBaseURL(value, source string) error {
+	if value != "" && !strings.HasPrefix(value, "http://") && !strings.HasPrefix(value, "https://") {
+		return fmt.Errorf("%s %q is missing a scheme (expected http:// or https://)", source, value)
+	}
+	return nil
+}
+
 func getDefaultRequestOptions(cmd *cli.Command) []option.RequestOption {
 	opts := []option.RequestOption{
 		option.WithHeader("User-Agent", fmt.Sprintf("BeeperDesktop/CLI %s", Version)),
diff --git a/pkg/cmd/cmdutil_test.go b/pkg/cmd/cmdutil_test.go
index 0a46fd1..8487408 100644
--- a/pkg/cmd/cmdutil_test.go
+++ b/pkg/cmd/cmdutil_test.go
@@ -125,3 +125,42 @@ func TestCreateDownloadFile(t *testing.T) {
 		assert.Equal(t, "passwd", filepath.Base(file.Name()))
 	})
 }
+
+func TestValidateBaseURL(t *testing.T) {
+	t.Parallel()
+
+	t.Run("ValidHTTPS", func(t *testing.T) {
+		t.Parallel()
+
+		require.NoError(t, ValidateBaseURL("https://api.example.com", "--base-url"))
+	})
+
+	t.Run("ValidHTTP", func(t *testing.T) {
+		t.Parallel()
+
+		require.NoError(t, ValidateBaseURL("http://localhost:8080", "--base-url"))
+	})
+
+	t.Run("Empty", func(t *testing.T) {
+		t.Parallel()
+
+		require.NoError(t, ValidateBaseURL("", "MY_BASE_URL"))
+	})
+
+	t.Run("MissingScheme", func(t *testing.T) {
+		t.Parallel()
+
+		err := ValidateBaseURL("localhost:8080", "MY_BASE_URL")
+		require.Error(t, err)
+		assert.Contains(t, err.Error(), "MY_BASE_URL")
+		assert.Contains(t, err.Error(), "missing a scheme")
+	})
+
+	t.Run("HostOnly", func(t *testing.T) {
+		t.Parallel()
+
+		err := ValidateBaseURL("api.example.com", "--base-url")
+		require.Error(t, err)
+		assert.Contains(t, err.Error(), "--base-url")
+	})
+}

From eacfea0f881332d854999d73092a4786d0b3ae33 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 3 Apr 2026 02:11:44 +0000
Subject: [PATCH 16/19] feat: allow `-` as value representing stdin to
 binary-only file parameters in CLIs

---
 pkg/cmd/flagoptions.go      | 103 +++++++++++++++++++++++++++++++++---
 pkg/cmd/flagoptions_test.go |  91 ++++++++++++++++++++++++++++++-
 2 files changed, 184 insertions(+), 10 deletions(-)

diff --git a/pkg/cmd/flagoptions.go b/pkg/cmd/flagoptions.go
index 24ed79a..198b295 100644
--- a/pkg/cmd/flagoptions.go
+++ b/pkg/cmd/flagoptions.go
@@ -40,12 +40,48 @@ const (
 	EmbedIOReader
 )
 
-func embedFiles(obj any, embedStyle FileEmbedStyle) (any, error) {
+// onceStdinReader wraps an io.Reader that can only be consumed once, used to ensure stdin is read by at most
+// one parameter (or only for a body root parameter or only for YAML parameter input). If reason is set, stdin
+// is unavailable and read() returns an error explaining why.
+type onceStdinReader struct {
+	stdinReader   io.Reader
+	failureReason string
+}
+
+func (o *onceStdinReader) read() (io.Reader, error) {
+	if o.failureReason != "" {
+		return nil, fmt.Errorf("cannot read from stdin: %s", o.failureReason)
+	}
+	if o.stdinReader == nil {
+		return nil, fmt.Errorf("stdin has already been read by another parameter; it can only be read once")
+	}
+	r := o.stdinReader
+	o.stdinReader = nil
+	return r, nil
+}
+
+func (o *onceStdinReader) readAll() ([]byte, error) {
+	r, err := o.read()
+	if err != nil {
+		return nil, err
+	}
+	return io.ReadAll(r)
+}
+
+func isStdinPath(s string) bool {
+	switch s {
+	case "-", "/dev/fd/0", "/dev/stdin":
+		return true
+	}
+	return false
+}
+
+func embedFiles(obj any, embedStyle FileEmbedStyle, stdin *onceStdinReader) (any, error) {
 	if obj == nil {
 		return obj, nil
 	}
 	v := reflect.ValueOf(obj)
-	result, err := embedFilesValue(v, embedStyle)
+	result, err := embedFilesValue(v, embedStyle, stdin)
 	if err != nil {
 		return nil, err
 	}
@@ -53,7 +89,7 @@ func embedFiles(obj any, embedStyle FileEmbedStyle) (any, error) {
 }
 
 // Replace "@file.txt" with the file's contents inside a value
-func embedFilesValue(v reflect.Value, embedStyle FileEmbedStyle) (reflect.Value, error) {
+func embedFilesValue(v reflect.Value, embedStyle FileEmbedStyle, stdin *onceStdinReader) (reflect.Value, error) {
 	// Unwrap interface values to get the concrete type
 	if v.Kind() == reflect.Interface {
 		if v.IsNil() {
@@ -74,7 +110,7 @@ func embedFilesValue(v reflect.Value, embedStyle FileEmbedStyle) (reflect.Value,
 		for iter.Next() {
 			key := iter.Key()
 			val := iter.Value()
-			newVal, err := embedFilesValue(val, embedStyle)
+			newVal, err := embedFilesValue(val, embedStyle, stdin)
 			if err != nil {
 				return reflect.Value{}, err
 			}
@@ -89,7 +125,7 @@ func embedFilesValue(v reflect.Value, embedStyle FileEmbedStyle) (reflect.Value,
 		// Use `[]any` to allow for types to change when embedding files
 		result := reflect.MakeSlice(reflect.TypeOf([]any{}), v.Len(), v.Len())
 		for i := 0; i < v.Len(); i++ {
-			newVal, err := embedFilesValue(v.Index(i), embedStyle)
+			newVal, err := embedFilesValue(v.Index(i), embedStyle, stdin)
 			if err != nil {
 				return reflect.Value{}, err
 			}
@@ -106,6 +142,13 @@ func embedFilesValue(v reflect.Value, embedStyle FileEmbedStyle) (reflect.Value,
 			if s == "" {
 				return v, nil
 			}
+			if isStdinPath(s) {
+				content, err := stdin.readAll()
+				if err != nil {
+					return v, err
+				}
+				return reflect.ValueOf(string(content)), nil
+			}
 			content, err := os.ReadFile(s)
 			if err != nil {
 				return v, err
@@ -123,6 +166,13 @@ func embedFilesValue(v reflect.Value, embedStyle FileEmbedStyle) (reflect.Value,
 			if filename, ok := strings.CutPrefix(s, "@data://"); ok {
 				// The "@data://" prefix is for files you explicitly want to upload
 				// as base64-encoded (even if the file itself is plain text)
+				if isStdinPath(filename) {
+					content, err := stdin.readAll()
+					if err != nil {
+						return v, err
+					}
+					return reflect.ValueOf(base64.StdEncoding.EncodeToString(content)), nil
+				}
 				content, err := os.ReadFile(filename)
 				if err != nil {
 					return v, err
@@ -132,12 +182,29 @@ func embedFilesValue(v reflect.Value, embedStyle FileEmbedStyle) (reflect.Value,
 				// The "@file://" prefix is for files that you explicitly want to
 				// upload as a string literal with backslash escapes (not base64
 				// encoded)
+				if isStdinPath(filename) {
+					content, err := stdin.readAll()
+					if err != nil {
+						return v, err
+					}
+					return reflect.ValueOf(string(content)), nil
+				}
 				content, err := os.ReadFile(filename)
 				if err != nil {
 					return v, err
 				}
 				return reflect.ValueOf(string(content)), nil
 			} else if filename, ok := strings.CutPrefix(s, "@"); ok {
+				if isStdinPath(filename) {
+					content, err := stdin.readAll()
+					if err != nil {
+						return v, err
+					}
+					if isUTF8TextFile(content) {
+						return reflect.ValueOf(string(content)), nil
+					}
+					return reflect.ValueOf(base64.StdEncoding.EncodeToString(content)), nil
+				}
 				content, err := os.ReadFile(filename)
 				if err != nil {
 					// If the string is "@username", it's probably supposed to be a
@@ -175,6 +242,14 @@ func embedFilesValue(v reflect.Value, embedStyle FileEmbedStyle) (reflect.Value,
 					expectsFile = strings.Contains(filename, ".") || strings.Contains(filename, "/")
 				}
 
+				if isStdinPath(filename) {
+					r, err := stdin.read()
+					if err != nil {
+						return v, err
+					}
+					return reflect.ValueOf(io.NopCloser(r)), nil
+				}
+
 				file, err := os.Open(filename)
 				if err != nil {
 					if !expectsFile {
@@ -234,6 +309,7 @@ func flagOptions(
 
 	requestContents := requestflag.ExtractRequestContents(cmd)
 
+	stdinConsumedByPipe := false
 	if (bodyType == MultipartFormEncoded || bodyType == ApplicationJSON) && !ignoreStdin && isInputPiped() {
 		pipeData, err := io.ReadAll(os.Stdin)
 		if err != nil {
@@ -241,6 +317,7 @@ func flagOptions(
 		}
 
 		if len(pipeData) > 0 {
+			stdinConsumedByPipe = true
 			var bodyData any
 			if err := yaml.Unmarshal(pipeData, &bodyData); err != nil {
 				return nil, fmt.Errorf("Failed to parse piped data as YAML/JSON:\n%w", err)
@@ -279,24 +356,34 @@ func flagOptions(
 	// via explicit CLI flags and values that arrived via piped YAML/JSON data.
 	wrapFileInputValues(cmd, &requestContents)
 
+	// Determine stdin availability for FileInput params that use "-".
+	var stdinReader onceStdinReader
+	if ignoreStdin {
+		stdinReader = onceStdinReader{failureReason: "stdin is already being used for the request body"}
+	} else if stdinConsumedByPipe {
+		stdinReader = onceStdinReader{failureReason: "stdin was already consumed by piped YAML/JSON input"}
+	} else {
+		stdinReader = onceStdinReader{stdinReader: os.Stdin}
+	}
+
 	// Embed files passed as "@file.jpg" in the request body, headers, and query:
 	embedStyle := EmbedText
 	if bodyType == ApplicationOctetStream || bodyType == MultipartFormEncoded {
 		embedStyle = EmbedIOReader
 	}
 
-	if embedded, err := embedFiles(requestContents.Body, embedStyle); err != nil {
+	if embedded, err := embedFiles(requestContents.Body, embedStyle, &stdinReader); err != nil {
 		return nil, err
 	} else {
 		requestContents.Body = embedded
 	}
 
-	if headersWithFiles, err := embedFiles(requestContents.Headers, EmbedText); err != nil {
+	if headersWithFiles, err := embedFiles(requestContents.Headers, EmbedText, &stdinReader); err != nil {
 		return nil, err
 	} else {
 		requestContents.Headers = headersWithFiles.(map[string]any)
 	}
-	if queriesWithFiles, err := embedFiles(requestContents.Queries, EmbedText); err != nil {
+	if queriesWithFiles, err := embedFiles(requestContents.Queries, EmbedText, &stdinReader); err != nil {
 		return nil, err
 	} else {
 		requestContents.Queries = queriesWithFiles.(map[string]any)
diff --git a/pkg/cmd/flagoptions_test.go b/pkg/cmd/flagoptions_test.go
index e5dad4b..9a7fe3b 100644
--- a/pkg/cmd/flagoptions_test.go
+++ b/pkg/cmd/flagoptions_test.go
@@ -2,8 +2,10 @@ package cmd
 
 import (
 	"encoding/base64"
+	"io"
 	"os"
 	"path/filepath"
+	"strings"
 	"testing"
 
 	"github.com/stretchr/testify/assert"
@@ -11,6 +13,7 @@ import (
 )
 
 func TestIsUTF8TextFile(t *testing.T) {
+
 	tests := []struct {
 		content  []byte
 		expected bool
@@ -32,6 +35,7 @@ func TestIsUTF8TextFile(t *testing.T) {
 }
 
 func TestEmbedFiles(t *testing.T) {
+
 	// Create temporary directory for test files
 	tmpDir := t.TempDir()
 
@@ -216,7 +220,8 @@ func TestEmbedFiles(t *testing.T) {
 
 	for _, tt := range tests {
 		t.Run(tt.name+" text", func(t *testing.T) {
-			got, err := embedFiles(tt.input, EmbedText)
+
+			got, err := embedFiles(tt.input, EmbedText, nil)
 			if tt.wantErr {
 				assert.Error(t, err)
 			} else {
@@ -226,7 +231,8 @@ func TestEmbedFiles(t *testing.T) {
 		})
 
 		t.Run(tt.name+" io.Reader", func(t *testing.T) {
-			_, err := embedFiles(tt.input, EmbedIOReader)
+
+			_, err := embedFiles(tt.input, EmbedIOReader, nil)
 			if tt.wantErr {
 				assert.Error(t, err)
 			} else {
@@ -236,9 +242,90 @@ func TestEmbedFiles(t *testing.T) {
 	}
 }
 
+func TestEmbedFilesStdin(t *testing.T) {
+
+	t.Run("FilePathValueDash", func(t *testing.T) {
+
+		stdin := &onceStdinReader{stdinReader: strings.NewReader("stdin content")}
+
+		withEmbedded, err := embedFiles(map[string]any{"file": FilePathValue("-")}, EmbedText, stdin)
+		require.NoError(t, err)
+		require.Equal(t, map[string]any{"file": "stdin content"}, withEmbedded)
+	})
+
+	t.Run("FilePathValueDevStdin", func(t *testing.T) {
+
+		stdin := &onceStdinReader{stdinReader: strings.NewReader("stdin content")}
+
+		withEmbedded, err := embedFiles(map[string]any{"file": FilePathValue("/dev/stdin")}, EmbedText, stdin)
+		require.NoError(t, err)
+		require.Equal(t, map[string]any{"file": "stdin content"}, withEmbedded)
+	})
+
+	t.Run("MultipleFilePathValueDashesError", func(t *testing.T) {
+
+		stdin := &onceStdinReader{stdinReader: strings.NewReader("stdin content")}
+
+		_, err := embedFiles(map[string]any{
+			"file1": FilePathValue("-"),
+			"file2": FilePathValue("-"),
+		}, EmbedText, stdin)
+		require.Error(t, err)
+		require.Contains(t, err.Error(), "already been read")
+	})
+
+	t.Run("FilePathValueDashUnavailableStdin", func(t *testing.T) {
+
+		stdin := &onceStdinReader{failureReason: "stdin is already being used for the request body"}
+
+		_, err := embedFiles(map[string]any{"file": FilePathValue("-")}, EmbedText, stdin)
+		require.Error(t, err)
+		require.Contains(t, err.Error(), "cannot read from stdin")
+		require.Contains(t, err.Error(), "request body")
+	})
+
+	t.Run("AtDashEmbedText", func(t *testing.T) {
+
+		stdin := &onceStdinReader{stdinReader: strings.NewReader("piped content")}
+
+		withEmbedded, err := embedFiles(map[string]any{"data": "@-"}, EmbedText, stdin)
+		require.NoError(t, err)
+		require.Equal(t, map[string]any{"data": "piped content"}, withEmbedded)
+	})
+
+	t.Run("AtDashEmbedIOReader", func(t *testing.T) {
+
+		stdin := &onceStdinReader{stdinReader: strings.NewReader("piped content")}
+
+		withEmbedded, err := embedFiles(map[string]any{"data": "@-"}, EmbedIOReader, stdin)
+		require.NoError(t, err)
+
+		withEmbeddedMap := withEmbedded.(map[string]any)
+		r := withEmbeddedMap["data"].(io.ReadCloser)
+
+		content, err := io.ReadAll(r)
+		require.NoError(t, err)
+		require.Equal(t, "piped content", string(content))
+	})
+
+	t.Run("FilePathValueRealFile", func(t *testing.T) {
+
+		tmpDir := t.TempDir()
+		writeTestFile(t, tmpDir, "test.txt", "file content")
+
+		stdin := &onceStdinReader{stdinReader: strings.NewReader("unused stdin")}
+
+		withEmbedded, err := embedFiles(map[string]any{"file": FilePathValue(filepath.Join(tmpDir, "test.txt"))}, EmbedText, stdin)
+		require.NoError(t, err)
+		require.Equal(t, map[string]any{"file": "file content"}, withEmbedded)
+	})
+}
+
 func writeTestFile(t *testing.T, dir, filename, content string) {
 	t.Helper()
+
 	path := filepath.Join(dir, filename)
+
 	err := os.WriteFile(path, []byte(content), 0644)
 	require.NoError(t, err, "failed to write test file %s", path)
 }

From c0de07ef35b6d776781b0347a102c3855445f0cb Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 3 Apr 2026 02:11:59 +0000
Subject: [PATCH 17/19] chore: switch some CLI Go tests from `os.Chdir` to
 `t.Chdir`

---
 pkg/cmd/cmdutil_test.go | 15 +++------------
 1 file changed, 3 insertions(+), 12 deletions(-)

diff --git a/pkg/cmd/cmdutil_test.go b/pkg/cmd/cmdutil_test.go
index 8487408..550c995 100644
--- a/pkg/cmd/cmdutil_test.go
+++ b/pkg/cmd/cmdutil_test.go
@@ -67,10 +67,7 @@ func TestWriteBinaryResponse(t *testing.T) {
 
 func TestCreateDownloadFile(t *testing.T) {
 	t.Run("creates file with filename from header", func(t *testing.T) {
-		tmpDir := t.TempDir()
-		oldWd, _ := os.Getwd()
-		os.Chdir(tmpDir)
-		defer os.Chdir(oldWd)
+		t.Chdir(t.TempDir())
 
 		resp := &http.Response{
 			Header: http.Header{
@@ -96,10 +93,7 @@ func TestCreateDownloadFile(t *testing.T) {
 	})
 
 	t.Run("creates temp file when no header", func(t *testing.T) {
-		tmpDir := t.TempDir()
-		oldWd, _ := os.Getwd()
-		os.Chdir(tmpDir)
-		defer os.Chdir(oldWd)
+		t.Chdir(t.TempDir())
 
 		resp := &http.Response{Header: http.Header{}}
 		file, err := createDownloadFile(resp, []byte("test content"))
@@ -109,10 +103,7 @@ func TestCreateDownloadFile(t *testing.T) {
 	})
 
 	t.Run("prevents directory traversal", func(t *testing.T) {
-		tmpDir := t.TempDir()
-		oldWd, _ := os.Getwd()
-		os.Chdir(tmpDir)
-		defer os.Chdir(oldWd)
+		t.Chdir(t.TempDir())
 
 		resp := &http.Response{
 			Header: http.Header{

From 59678e17b692460f3fdc03ca82ba6270d13ed460 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 3 Apr 2026 02:12:15 +0000
Subject: [PATCH 18/19] chore: mark all CLI-related tests in Go with
 `t.Parallel()`

---
 internal/apiform/form_test.go              |  4 ++
 internal/apiquery/query_test.go            |  4 ++
 internal/autocomplete/autocomplete_test.go | 40 +++++++++++++++
 internal/jsonview/explorer_test.go         |  6 +++
 internal/requestflag/innerflag_test.go     | 28 +++++++++++
 internal/requestflag/requestflag_test.go   | 58 ++++++++++++++++++++++
 pkg/cmd/flagoptions_test.go                | 12 +++++
 7 files changed, 152 insertions(+)

diff --git a/internal/apiform/form_test.go b/internal/apiform/form_test.go
index 2cf5bdd..f68cfd1 100644
--- a/internal/apiform/form_test.go
+++ b/internal/apiform/form_test.go
@@ -85,8 +85,12 @@ var tests = map[string]struct {
 }
 
 func TestEncode(t *testing.T) {
+	t.Parallel()
+
 	for name, test := range tests {
 		t.Run(name, func(t *testing.T) {
+			t.Parallel()
+
 			buf := bytes.NewBuffer(nil)
 			writer := multipart.NewWriter(buf)
 			writer.SetBoundary("xxx")
diff --git a/internal/apiquery/query_test.go b/internal/apiquery/query_test.go
index 8bee784..3791ec9 100644
--- a/internal/apiquery/query_test.go
+++ b/internal/apiquery/query_test.go
@@ -6,6 +6,8 @@ import (
 )
 
 func TestEncode(t *testing.T) {
+	t.Parallel()
+
 	tests := map[string]struct {
 		val      any
 		settings QuerySettings
@@ -114,6 +116,8 @@ func TestEncode(t *testing.T) {
 
 	for name, test := range tests {
 		t.Run(name, func(t *testing.T) {
+			t.Parallel()
+
 			query := map[string]any{"query": test.val}
 			values, err := MarshalWithSettings(query, test.settings)
 			if err != nil {
diff --git a/internal/autocomplete/autocomplete_test.go b/internal/autocomplete/autocomplete_test.go
index 3e8aa33..2338924 100644
--- a/internal/autocomplete/autocomplete_test.go
+++ b/internal/autocomplete/autocomplete_test.go
@@ -8,6 +8,8 @@ import (
 )
 
 func TestGetCompletions_EmptyArgs(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "generate", Usage: "Generate SDK"},
@@ -26,6 +28,8 @@ func TestGetCompletions_EmptyArgs(t *testing.T) {
 }
 
 func TestGetCompletions_SubcommandPrefix(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "generate", Usage: "Generate SDK"},
@@ -43,6 +47,8 @@ func TestGetCompletions_SubcommandPrefix(t *testing.T) {
 }
 
 func TestGetCompletions_HiddenCommand(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "visible", Usage: "Visible command"},
@@ -57,6 +63,8 @@ func TestGetCompletions_HiddenCommand(t *testing.T) {
 }
 
 func TestGetCompletions_NestedSubcommand(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{
@@ -79,6 +87,8 @@ func TestGetCompletions_NestedSubcommand(t *testing.T) {
 }
 
 func TestGetCompletions_FlagCompletion(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{
@@ -102,6 +112,8 @@ func TestGetCompletions_FlagCompletion(t *testing.T) {
 }
 
 func TestGetCompletions_ShortFlagCompletion(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{
@@ -123,6 +135,8 @@ func TestGetCompletions_ShortFlagCompletion(t *testing.T) {
 }
 
 func TestGetCompletions_FileFlagBehavior(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{
@@ -142,6 +156,8 @@ func TestGetCompletions_FileFlagBehavior(t *testing.T) {
 }
 
 func TestGetCompletions_NonBoolFlagValue(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{
@@ -161,6 +177,8 @@ func TestGetCompletions_NonBoolFlagValue(t *testing.T) {
 }
 
 func TestGetCompletions_BoolFlagDoesNotBlockCompletion(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{
@@ -185,6 +203,8 @@ func TestGetCompletions_BoolFlagDoesNotBlockCompletion(t *testing.T) {
 }
 
 func TestGetCompletions_ColonCommands_NoColonTyped(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "config:get", Usage: "Get config value"},
@@ -202,6 +222,8 @@ func TestGetCompletions_ColonCommands_NoColonTyped(t *testing.T) {
 }
 
 func TestGetCompletions_ColonCommands_ColonTyped_Bash(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "config:get", Usage: "Get config value"},
@@ -221,6 +243,8 @@ func TestGetCompletions_ColonCommands_ColonTyped_Bash(t *testing.T) {
 }
 
 func TestGetCompletions_ColonCommands_ColonTyped_Zsh(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "config:get", Usage: "Get config value"},
@@ -240,6 +264,8 @@ func TestGetCompletions_ColonCommands_ColonTyped_Zsh(t *testing.T) {
 }
 
 func TestGetCompletions_BashStyleColonCompletion(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "config:get", Usage: "Get config value"},
@@ -257,6 +283,8 @@ func TestGetCompletions_BashStyleColonCompletion(t *testing.T) {
 }
 
 func TestGetCompletions_BashStyleColonCompletion_NoMatch(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "config:get", Usage: "Get config value"},
@@ -271,6 +299,8 @@ func TestGetCompletions_BashStyleColonCompletion_NoMatch(t *testing.T) {
 }
 
 func TestGetCompletions_ZshStyleColonCompletion(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "config:get", Usage: "Get config value"},
@@ -287,6 +317,8 @@ func TestGetCompletions_ZshStyleColonCompletion(t *testing.T) {
 }
 
 func TestGetCompletions_MixedColonAndRegularCommands(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "generate", Usage: "Generate SDK"},
@@ -305,6 +337,8 @@ func TestGetCompletions_MixedColonAndRegularCommands(t *testing.T) {
 }
 
 func TestGetCompletions_FlagWithBoolFlagSkipsValue(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{
@@ -329,6 +363,8 @@ func TestGetCompletions_FlagWithBoolFlagSkipsValue(t *testing.T) {
 }
 
 func TestGetCompletions_MultipleFlagsBeforeSubcommand(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{
@@ -353,6 +389,8 @@ func TestGetCompletions_MultipleFlagsBeforeSubcommand(t *testing.T) {
 }
 
 func TestGetCompletions_CommandAliases(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{Name: "generate", Aliases: []string{"gen", "g"}, Usage: "Generate SDK"},
@@ -372,6 +410,8 @@ func TestGetCompletions_CommandAliases(t *testing.T) {
 }
 
 func TestGetCompletions_AllFlagsWhenNoPrefix(t *testing.T) {
+	t.Parallel()
+
 	root := &cli.Command{
 		Commands: []*cli.Command{
 			{
diff --git a/internal/jsonview/explorer_test.go b/internal/jsonview/explorer_test.go
index c559254..67ee730 100644
--- a/internal/jsonview/explorer_test.go
+++ b/internal/jsonview/explorer_test.go
@@ -10,6 +10,8 @@ import (
 )
 
 func TestNavigateForward_EmptyRowData(t *testing.T) {
+	t.Parallel()
+
 	// An empty JSON array produces a TableView with no rows.
 	emptyArray := gjson.Parse("[]")
 	view, err := newTableView("", emptyArray, false)
@@ -38,6 +40,8 @@ type rawJSONItem struct {
 func (r rawJSONItem) RawJSON() string { return r.raw }
 
 func TestMarshalItemsToJSONArray_WithHasRawJSON(t *testing.T) {
+	t.Parallel()
+
 	items := []any{
 		rawJSONItem{raw: `{"id":1,"name":"alice"}`},
 		rawJSONItem{raw: `{"id":2,"name":"bob"}`},
@@ -49,6 +53,8 @@ func TestMarshalItemsToJSONArray_WithHasRawJSON(t *testing.T) {
 }
 
 func TestMarshalItemsToJSONArray_WithoutHasRawJSON(t *testing.T) {
+	t.Parallel()
+
 	items := []any{
 		map[string]any{"id": 1, "name": "alice"},
 		map[string]any{"id": 2, "name": "bob"},
diff --git a/internal/requestflag/innerflag_test.go b/internal/requestflag/innerflag_test.go
index 3f204c9..133e8b4 100644
--- a/internal/requestflag/innerflag_test.go
+++ b/internal/requestflag/innerflag_test.go
@@ -8,6 +8,8 @@ import (
 )
 
 func TestInnerFlagSet(t *testing.T) {
+	t.Parallel()
+
 	tests := []struct {
 		name      string
 		flagType  string
@@ -27,6 +29,8 @@ func TestInnerFlagSet(t *testing.T) {
 
 	for _, tt := range tests {
 		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
 			outerFlag := &Flag[map[string]any]{
 				Name: "test-flag",
 			}
@@ -81,6 +85,8 @@ func TestInnerFlagSet(t *testing.T) {
 }
 
 func TestInnerFlagValidator(t *testing.T) {
+	t.Parallel()
+
 	outerFlag := &Flag[map[string]any]{Name: "test-flag"}
 
 	innerFlag := &InnerFlag[int64]{
@@ -105,6 +111,8 @@ func TestInnerFlagValidator(t *testing.T) {
 }
 
 func TestWithInnerFlags(t *testing.T) {
+	t.Parallel()
+
 	outerFlag := &Flag[map[string]any]{Name: "outer"}
 	innerFlag := &InnerFlag[string]{
 		Name:       "outer.baz",
@@ -126,6 +134,8 @@ func TestWithInnerFlags(t *testing.T) {
 }
 
 func TestInnerFlagTypeNames(t *testing.T) {
+	t.Parallel()
+
 	tests := []struct {
 		name     string
 		flag     cli.DocGenerationFlag
@@ -143,6 +153,8 @@ func TestInnerFlagTypeNames(t *testing.T) {
 
 	for _, tt := range tests {
 		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
 			typeName := tt.flag.TypeName()
 			assert.Equal(t, tt.expected, typeName, "Expected type name %q, got %q", tt.expected, typeName)
 		})
@@ -150,8 +162,12 @@ func TestInnerFlagTypeNames(t *testing.T) {
 }
 
 func TestInnerYamlHandling(t *testing.T) {
+	t.Parallel()
+
 	// Test with map value
 	t.Run("Parse YAML to map", func(t *testing.T) {
+		t.Parallel()
+
 		outerFlag := &Flag[map[string]any]{Name: "outer"}
 		innerFlag := &InnerFlag[map[string]any]{
 			Name:       "outer.baz",
@@ -176,6 +192,8 @@ func TestInnerYamlHandling(t *testing.T) {
 
 	// Test with invalid YAML
 	t.Run("Parse invalid YAML", func(t *testing.T) {
+		t.Parallel()
+
 		outerFlag := &Flag[map[string]any]{Name: "outer"}
 		innerFlag := &InnerFlag[map[string]any]{
 			Name:       "outer.baz",
@@ -190,6 +208,8 @@ func TestInnerYamlHandling(t *testing.T) {
 
 	// Test setting inner flags on a map multiple times
 	t.Run("Set inner flags on map multiple times", func(t *testing.T) {
+		t.Parallel()
+
 		outerFlag := &Flag[map[string]any]{Name: "outer"}
 
 		// Set first inner flag
@@ -219,6 +239,8 @@ func TestInnerYamlHandling(t *testing.T) {
 
 	// Test setting YAML and then an inner flag
 	t.Run("Set YAML and then inner flag", func(t *testing.T) {
+		t.Parallel()
+
 		outerFlag := &Flag[map[string]any]{Name: "outer"}
 
 		// First set the outer flag with YAML
@@ -246,7 +268,11 @@ func TestInnerYamlHandling(t *testing.T) {
 }
 
 func TestInnerFlagWithSliceType(t *testing.T) {
+	t.Parallel()
+
 	t.Run("Setting inner flags on slice of maps", func(t *testing.T) {
+		t.Parallel()
+
 		outerFlag := &Flag[[]map[string]any]{Name: "outer"}
 
 		// Set first inner flag (should create first item)
@@ -284,6 +310,8 @@ func TestInnerFlagWithSliceType(t *testing.T) {
 	})
 
 	t.Run("Appending to existing slice", func(t *testing.T) {
+		t.Parallel()
+
 		// Initialize with existing items
 		outerFlag := &Flag[[]map[string]any]{Name: "outer"}
 		err := outerFlag.Set(outerFlag.Name, `{name: initial}`)
diff --git a/internal/requestflag/requestflag_test.go b/internal/requestflag/requestflag_test.go
index 9751904..0e86e07 100644
--- a/internal/requestflag/requestflag_test.go
+++ b/internal/requestflag/requestflag_test.go
@@ -11,6 +11,8 @@ import (
 )
 
 func TestDateValueParse(t *testing.T) {
+	t.Parallel()
+
 	tests := []struct {
 		name    string
 		input   string
@@ -56,6 +58,8 @@ func TestDateValueParse(t *testing.T) {
 
 	for _, tt := range tests {
 		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
 			var d DateValue
 			err := d.Parse(tt.input)
 
@@ -70,6 +74,8 @@ func TestDateValueParse(t *testing.T) {
 }
 
 func TestDateTimeValueParse(t *testing.T) {
+	t.Parallel()
+
 	tests := []struct {
 		name    string
 		input   string
@@ -119,6 +125,8 @@ func TestDateTimeValueParse(t *testing.T) {
 
 	for _, tt := range tests {
 		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
 			var d DateTimeValue
 			err := d.Parse(tt.input)
 
@@ -136,6 +144,8 @@ func TestDateTimeValueParse(t *testing.T) {
 }
 
 func TestTimeValueParse(t *testing.T) {
+	t.Parallel()
+
 	tests := []struct {
 		name    string
 		input   string
@@ -181,6 +191,8 @@ func TestTimeValueParse(t *testing.T) {
 
 	for _, tt := range tests {
 		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
 			var tv TimeValue
 			err := tv.Parse(tt.input)
 
@@ -195,7 +207,11 @@ func TestTimeValueParse(t *testing.T) {
 }
 
 func TestRequestParams(t *testing.T) {
+	t.Parallel()
+
 	t.Run("map body type", func(t *testing.T) {
+		t.Parallel()
+
 		// Create a mock command with flags
 		cmd := &cli.Command{
 			Name: "test",
@@ -283,6 +299,8 @@ func TestRequestParams(t *testing.T) {
 	})
 
 	t.Run("non-map body type", func(t *testing.T) {
+		t.Parallel()
+
 		// Create a mock command with flags
 		cmd := &cli.Command{
 			Name: "test",
@@ -304,6 +322,8 @@ func TestRequestParams(t *testing.T) {
 }
 
 func TestFlagSet(t *testing.T) {
+	t.Parallel()
+
 	strFlag := &Flag[string]{
 		Name:    "string-flag",
 		Default: "default-string",
@@ -327,38 +347,52 @@ func TestFlagSet(t *testing.T) {
 
 	// Test initialization and setting
 	t.Run("PreParse initialization", func(t *testing.T) {
+		t.Parallel()
+
 		assert.NoError(t, strFlag.PreParse())
 		assert.True(t, strFlag.applied)
 		assert.Equal(t, "default-string", strFlag.Get())
 	})
 
 	t.Run("Set string flag", func(t *testing.T) {
+		t.Parallel()
+
 		assert.NoError(t, strFlag.Set("string-flag", "new-value"))
 		assert.Equal(t, "new-value", strFlag.Get())
 		assert.True(t, strFlag.IsSet())
 	})
 
 	t.Run("Set int flag with valid value", func(t *testing.T) {
+		t.Parallel()
+
 		assert.NoError(t, superstitiousIntFlag.Set("int-flag", "100"))
 		assert.Equal(t, int64(100), superstitiousIntFlag.Get())
 		assert.True(t, superstitiousIntFlag.IsSet())
 	})
 
 	t.Run("Set int flag with invalid value", func(t *testing.T) {
+		t.Parallel()
+
 		assert.Error(t, superstitiousIntFlag.Set("int-flag", "not-an-int"))
 	})
 
 	t.Run("Set int flag with validator failing", func(t *testing.T) {
+		t.Parallel()
+
 		assert.Error(t, superstitiousIntFlag.Set("int-flag", "13"))
 	})
 
 	t.Run("Set bool flag", func(t *testing.T) {
+		t.Parallel()
+
 		assert.NoError(t, boolFlag.Set("bool-flag", "true"))
 		assert.Equal(t, true, boolFlag.Get())
 		assert.True(t, boolFlag.IsSet())
 	})
 
 	t.Run("Set slice flag with multiple values", func(t *testing.T) {
+		t.Parallel()
+
 		sliceFlag := &Flag[[]int64]{
 			Name:    "slice-flag",
 			Default: []int64{},
@@ -381,6 +415,8 @@ func TestFlagSet(t *testing.T) {
 	})
 
 	t.Run("Set slice flag with a nonempty default", func(t *testing.T) {
+		t.Parallel()
+
 		sliceFlag := &Flag[[]int64]{
 			Name:    "slice-flag",
 			Default: []int64{99, 100},
@@ -400,6 +436,8 @@ func TestFlagSet(t *testing.T) {
 }
 
 func TestParseTimeWithFormats(t *testing.T) {
+	t.Parallel()
+
 	tests := []struct {
 		name     string
 		input    string
@@ -439,6 +477,8 @@ func TestParseTimeWithFormats(t *testing.T) {
 
 	for _, tt := range tests {
 		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
 			got, err := parseTimeWithFormats(tt.input, tt.formats)
 
 			if tt.wantErr {
@@ -452,8 +492,12 @@ func TestParseTimeWithFormats(t *testing.T) {
 }
 
 func TestYamlHandling(t *testing.T) {
+	t.Parallel()
+
 	// Test with any value
 	t.Run("Parse YAML to any", func(t *testing.T) {
+		t.Parallel()
+
 		cv := &cliValue[any]{}
 		err := cv.Set("name: test\nvalue: 42\n")
 		assert.NoError(t, err)
@@ -478,6 +522,8 @@ func TestYamlHandling(t *testing.T) {
 
 	// Test with array
 	t.Run("Parse YAML array", func(t *testing.T) {
+		t.Parallel()
+
 		cv := &cliValue[any]{}
 		err := cv.Set("- item1\n- item2\n- item3\n")
 		assert.NoError(t, err)
@@ -495,6 +541,8 @@ func TestYamlHandling(t *testing.T) {
 	})
 
 	t.Run("Parse @file.txt as YAML", func(t *testing.T) {
+		t.Parallel()
+
 		flag := &Flag[any]{
 			Name:    "file-flag",
 			Default: nil,
@@ -507,6 +555,8 @@ func TestYamlHandling(t *testing.T) {
 	})
 
 	t.Run("Parse @file.txt list as YAML", func(t *testing.T) {
+		t.Parallel()
+
 		flag := &Flag[[]any]{
 			Name:    "file-flag",
 			Default: nil,
@@ -520,6 +570,8 @@ func TestYamlHandling(t *testing.T) {
 	})
 
 	t.Run("Parse identifiers as YAML", func(t *testing.T) {
+		t.Parallel()
+
 		tests := []string{
 			"hello",
 			"e4e355fa-b03b-4c57-a73d-25c9733eec79",
@@ -555,6 +607,8 @@ func TestYamlHandling(t *testing.T) {
 
 	// Test with invalid YAML
 	t.Run("Parse invalid YAML", func(t *testing.T) {
+		t.Parallel()
+
 		invalidYaml := `[not closed`
 		cv := &cliValue[any]{}
 		err := cv.Set(invalidYaml)
@@ -563,6 +617,8 @@ func TestYamlHandling(t *testing.T) {
 }
 
 func TestFlagTypeNames(t *testing.T) {
+	t.Parallel()
+
 	tests := []struct {
 		name     string
 		flag     cli.DocGenerationFlag
@@ -583,6 +639,8 @@ func TestFlagTypeNames(t *testing.T) {
 
 	for _, tt := range tests {
 		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
 			typeName := tt.flag.TypeName()
 			assert.Equal(t, tt.expected, typeName, "Expected type name %q, got %q", tt.expected, typeName)
 		})
diff --git a/pkg/cmd/flagoptions_test.go b/pkg/cmd/flagoptions_test.go
index 9a7fe3b..039b9ff 100644
--- a/pkg/cmd/flagoptions_test.go
+++ b/pkg/cmd/flagoptions_test.go
@@ -13,6 +13,7 @@ import (
 )
 
 func TestIsUTF8TextFile(t *testing.T) {
+	t.Parallel()
 
 	tests := []struct {
 		content  []byte
@@ -35,6 +36,7 @@ func TestIsUTF8TextFile(t *testing.T) {
 }
 
 func TestEmbedFiles(t *testing.T) {
+	t.Parallel()
 
 	// Create temporary directory for test files
 	tmpDir := t.TempDir()
@@ -220,6 +222,7 @@ func TestEmbedFiles(t *testing.T) {
 
 	for _, tt := range tests {
 		t.Run(tt.name+" text", func(t *testing.T) {
+			t.Parallel()
 
 			got, err := embedFiles(tt.input, EmbedText, nil)
 			if tt.wantErr {
@@ -231,6 +234,7 @@ func TestEmbedFiles(t *testing.T) {
 		})
 
 		t.Run(tt.name+" io.Reader", func(t *testing.T) {
+			t.Parallel()
 
 			_, err := embedFiles(tt.input, EmbedIOReader, nil)
 			if tt.wantErr {
@@ -243,8 +247,10 @@ func TestEmbedFiles(t *testing.T) {
 }
 
 func TestEmbedFilesStdin(t *testing.T) {
+	t.Parallel()
 
 	t.Run("FilePathValueDash", func(t *testing.T) {
+		t.Parallel()
 
 		stdin := &onceStdinReader{stdinReader: strings.NewReader("stdin content")}
 
@@ -254,6 +260,7 @@ func TestEmbedFilesStdin(t *testing.T) {
 	})
 
 	t.Run("FilePathValueDevStdin", func(t *testing.T) {
+		t.Parallel()
 
 		stdin := &onceStdinReader{stdinReader: strings.NewReader("stdin content")}
 
@@ -263,6 +270,7 @@ func TestEmbedFilesStdin(t *testing.T) {
 	})
 
 	t.Run("MultipleFilePathValueDashesError", func(t *testing.T) {
+		t.Parallel()
 
 		stdin := &onceStdinReader{stdinReader: strings.NewReader("stdin content")}
 
@@ -275,6 +283,7 @@ func TestEmbedFilesStdin(t *testing.T) {
 	})
 
 	t.Run("FilePathValueDashUnavailableStdin", func(t *testing.T) {
+		t.Parallel()
 
 		stdin := &onceStdinReader{failureReason: "stdin is already being used for the request body"}
 
@@ -285,6 +294,7 @@ func TestEmbedFilesStdin(t *testing.T) {
 	})
 
 	t.Run("AtDashEmbedText", func(t *testing.T) {
+		t.Parallel()
 
 		stdin := &onceStdinReader{stdinReader: strings.NewReader("piped content")}
 
@@ -294,6 +304,7 @@ func TestEmbedFilesStdin(t *testing.T) {
 	})
 
 	t.Run("AtDashEmbedIOReader", func(t *testing.T) {
+		t.Parallel()
 
 		stdin := &onceStdinReader{stdinReader: strings.NewReader("piped content")}
 
@@ -309,6 +320,7 @@ func TestEmbedFilesStdin(t *testing.T) {
 	})
 
 	t.Run("FilePathValueRealFile", func(t *testing.T) {
+		t.Parallel()
 
 		tmpDir := t.TempDir()
 		writeTestFile(t, tmpDir, "test.txt", "file content")

From 9c4fd930ffabba1aba51c07cc438bb76ee784354 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 3 Apr 2026 02:12:30 +0000
Subject: [PATCH 19/19] release: 0.4.0

---
 .release-please-manifest.json |  2 +-
 CHANGELOG.md                  | 30 ++++++++++++++++++++++++++++++
 pkg/cmd/version.go            |  2 +-
 3 files changed, 32 insertions(+), 2 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 6b7b74c..da59f99 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.3.0"
+  ".": "0.4.0"
 }
\ No newline at end of file
diff --git a/CHANGELOG.md b/CHANGELOG.md
index a8fa2ac..cb54a73 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,35 @@
 # Changelog
 
+## 0.4.0 (2026-04-03)
+
+Full Changelog: [v0.3.0...v0.4.0](https://github.com/beeper/desktop-api-cli/compare/v0.3.0...v0.4.0)
+
+### Features
+
+* allow `-` as value representing stdin to binary-only file parameters in CLIs ([eacfea0](https://github.com/beeper/desktop-api-cli/commit/eacfea0f881332d854999d73092a4786d0b3ae33))
+* better error message if scheme forgotten in CLI `*_BASE_URL`/`--base-url` ([8d976d4](https://github.com/beeper/desktop-api-cli/commit/8d976d441c86ddfaa67c8fad50a156f9374e0d16))
+* binary-only parameters become CLI flags that take filenames only ([ed64986](https://github.com/beeper/desktop-api-cli/commit/ed64986c234a83e6c875a1202a7c217df9efa206))
+* set CLI flag constant values automatically where `x-stainless-const` is set ([c332ed8](https://github.com/beeper/desktop-api-cli/commit/c332ed822bc6e94cb521620032bdcf941d4b7593))
+
+
+### Bug Fixes
+
+* fix for off-by-one error in pagination logic ([16566c5](https://github.com/beeper/desktop-api-cli/commit/16566c5d80a77de14f33e1895ec72cfa89da99c7))
+* handle empty data set using `--format explore` ([6df0024](https://github.com/beeper/desktop-api-cli/commit/6df00248f562bbbd98e7cbccf8ddd82b35a40ae3))
+* use `RawJSON` when iterating items with `--format explore` in the CLI ([4af189d](https://github.com/beeper/desktop-api-cli/commit/4af189dc0e5add5c654204e0e90c91e199de479a))
+
+
+### Chores
+
+* **ci:** skip lint on metadata-only changes ([d18d972](https://github.com/beeper/desktop-api-cli/commit/d18d972e88c1a03890fcbe3ba2f0dbffb06f5e48))
+* **internal:** update multipart form array serialization ([180bf35](https://github.com/beeper/desktop-api-cli/commit/180bf353b36de3cfee9e9497dca4558622654e18))
+* mark all CLI-related tests in Go with `t.Parallel()` ([59678e1](https://github.com/beeper/desktop-api-cli/commit/59678e17b692460f3fdc03ca82ba6270d13ed460))
+* omit full usage information when missing required CLI parameters ([8b749cf](https://github.com/beeper/desktop-api-cli/commit/8b749cf09b595e66687d4030cee0791aff7e14c4))
+* switch some CLI Go tests from `os.Chdir` to `t.Chdir` ([c0de07e](https://github.com/beeper/desktop-api-cli/commit/c0de07ef35b6d776781b0347a102c3855445f0cb))
+* **tests:** bump steady to v0.19.7 ([c7c519c](https://github.com/beeper/desktop-api-cli/commit/c7c519cf80adffc7cebbd3ec220227baf48672d7))
+* **tests:** bump steady to v0.20.1 ([533501d](https://github.com/beeper/desktop-api-cli/commit/533501d2960fc565d5891d5f610a7feef458d0b2))
+* **tests:** bump steady to v0.20.2 ([3a7b085](https://github.com/beeper/desktop-api-cli/commit/3a7b085b2130d21ee0a2b434dbaa3efada1e1bb3))
+
 ## 0.3.0 (2026-03-24)
 
 Full Changelog: [v0.2.0...v0.3.0](https://github.com/beeper/desktop-api-cli/compare/v0.2.0...v0.3.0)
diff --git a/pkg/cmd/version.go b/pkg/cmd/version.go
index 5266c84..b113456 100644
--- a/pkg/cmd/version.go
+++ b/pkg/cmd/version.go
@@ -2,4 +2,4 @@
 
 package cmd
 
-const Version = "0.3.0" // x-release-please-version
+const Version = "0.4.0" // x-release-please-version