Sync open source content 🐝 (from 20f7f20c1b34a55b59694d70ab24e374242ab391)

Author: beezythebot

docs/speakeasy-reference/cli/index.md

@@ -57,7 +57,7 @@ speakeasy [flags]
 * [speakeasy merge](/docs/speakeasy-reference/cli/merge)	 - Merge multiple OpenAPI documents into a single document
 * [speakeasy openapi](/docs/speakeasy-reference/cli/openapi)	 - Utilities for working with OpenAPI documents
 * [speakeasy overlay](/docs/speakeasy-reference/cli/overlay)	 - Work with OpenAPI Overlays
-* [speakeasy pull](/docs/speakeasy-reference/cli/pull)	 - pull a spec from the registry
+* [speakeasy pull](/docs/speakeasy-reference/cli/pull)	 - Pull a spec from the registry or list available specs/tags
 * [speakeasy quickstart](/docs/speakeasy-reference/cli/quickstart)	 - Guided setup to help you create a new SDK in minutes.
 * [speakeasy repro](/docs/speakeasy-reference/cli/repro)	 - Reproduce a failed generation locally
 * [speakeasy run](/docs/speakeasy-reference/cli/run)	 - Run all the workflows defined in your workflow.yaml file. This can include multiple SDK generations from different OpenAPI sources

docs/speakeasy-reference/cli/pull.md

@@ -2,11 +2,26 @@
 `speakeasy pull`  
 
 
-pull a spec from the registry  
+Pull a spec from the registry or list available specs/tags  
 
 ## Details
 
-pull a spec from the registry
+Pull a spec from the registry or list available specs/tags.
+
+Examples:
+  # List all available specs in your workspace
+  speakeasy pull --list
+  speakeasy pull --list --format=json
+
+  # List available tags for a specific spec
+  speakeasy pull --spec=my-api --list-tags
+  speakeasy pull --spec=my-api --list-tags --format=json
+
+  # Pull a spec to the current directory
+  speakeasy pull --spec=my-api --revision=latest
+
+  # Pull a specific revision to a custom directory
+  speakeasy pull --spec=my-api --revision=v1.0.0 --output-dir=./specs
 
 ## Usage
 
@@ -17,10 +32,13 @@ speakeasy pull [flags]
 ### Options
 
 ```
+      --format string       Output format for --list and --list-tags (table, json) (default "table")
   -h, --help                help for pull
-      --output-dir string   The directory to output the image to (default "/home/runner/work/speakeasy/speakeasy/speakeasy")
-      --revision string     The revision to pull (default "latest")
-      --spec string         The name of the spec to want to pull
+      --list                List all available specs in your workspace (non-interactive)
+      --list-tags           List available tags for a spec (requires --spec)
+      --output-dir string   The directory to output the spec bundle to (default "/home/runner/work/speakeasy/speakeasy/speakeasy")
+      --revision string     The revision/tag to pull (default "latest")
+      --spec string         The name of the spec to pull or list tags for
 ```
 
 ### Options inherited from parent commands

docs/speakeasy-reference/cli/quickstart.md

@@ -20,11 +20,12 @@ speakeasy quickstart [flags]
   -f, --from string           template to use for the quickstart command.
                               Create a new sandbox at https://app.speakeasy.com/sandbox
   -h, --help                  help for quickstart
+      --init-git              initialize a git repository in the output directory
   -n, --name string           SDK name in PascalCase (e.g., "MyCompanySDK"). Users access SDK methods with myCompanySDK.DoThing()
   -o, --out-dir string        output directory for the quickstart command
       --output string         how to display output (available options: [summary, console, mermaid]) (default "summary")
   -p, --package-name string   package name for the generated SDK (e.g., "my-company-sdk" for npm, Go module path for Go)
-  -s, --schema string         local filepath, URL, or registry reference (org/workspace/namespace) for the OpenAPI schema
+  -s, --schema string         local filepath, URL, or registry reference for the OpenAPI schema (e.g., ./spec.yaml, https://..., namespace, org/workspace/namespace@tag)
       --skip-compile          skip compilation during generation after setup
   -t, --target string         generation target (available options: [csharp, go, java, mcp-typescript, php, postman, python, ruby, terraform, typescript, unity])
 ```