From 4d3679a59b6791f6361ca7cd143d19ffbfb043b9 Mon Sep 17 00:00:00 2001
From: robobun <117481402+robobun@users.noreply.github.com>
Date: Sat, 15 Aug 2026 02:55:03 +0000
Subject: [PATCH] docs(pm): add the missing flags to the bun install and bun
 add flag references

bun install --help lists --linker, --minimum-release-age, --cpu, --os and
--catalog, and bun add --help lists all but --catalog (which add.mdx
already documents); the flag reference snippets did not mention them.
---
 docs/snippets/cli/add.mdx     | 20 ++++++++++++++++++++
 docs/snippets/cli/install.mdx | 25 +++++++++++++++++++++++++
 2 files changed, 45 insertions(+)

diff --git a/docs/snippets/cli/add.mdx b/docs/snippets/cli/add.mdx
index c12f274153b1..d94a9461a694 100644
--- a/docs/snippets/cli/add.mdx
+++ b/docs/snippets/cli/add.mdx
@@ -100,6 +100,14 @@ bun add <package> <@version>
   <code>-a</code>
 </ParamField>
 
+<ParamField path="--linker" type="string">
+  Linker strategy (one of <code>isolated</code> or <code>hoisted</code>)
+</ParamField>
+
+<ParamField path="--minimum-release-age" type="number">
+  Only install package versions published at least this many seconds ago
+</ParamField>
+
 ### Network & Registry
 
 <ParamField path="--ca" type="string">
@@ -158,6 +166,18 @@ bun add <package> <@version>
   Don't print a summary
 </ParamField>
 
+### Platform Targeting
+
+<ParamField path="--cpu" type="string">
+  Override CPU architecture for optional dependencies (e.g., <code>x64</code>, <code>arm64</code>, <code>*</code> for
+  all)
+</ParamField>
+
+<ParamField path="--os" type="string">
+  Override operating system for optional dependencies (e.g., <code>linux</code>, <code>darwin</code>, <code>*</code> for
+  all)
+</ParamField>
+
 ### Global Configuration &amp; Context
 
 <ParamField path="--config" type="string">
diff --git a/docs/snippets/cli/install.mdx b/docs/snippets/cli/install.mdx
index 3b4c93cb9f05..0c5efb8df43e 100644
--- a/docs/snippets/cli/install.mdx
+++ b/docs/snippets/cli/install.mdx
@@ -54,6 +54,11 @@ bun install <name>@<version>
   Add the exact version instead of the ^ range
 </ParamField>
 
+<ParamField path="--catalog" type="string">
+  Add the resolved version to the root <code>package.json</code> catalog and depend on it as <code>catalog:</code>;{" "}
+  <code>--catalog=NAME</code> targets <code>catalogs.NAME</code>
+</ParamField>
+
 ### Lockfile Control
 
 <ParamField path="--yarn" type="boolean">
@@ -104,6 +109,10 @@ bun install <name>@<version>
   Platform-specific optimizations: "clonefile", "hardlink", "symlink", "copyfile"
 </ParamField>
 
+<ParamField path="--linker" type="string">
+  Linker strategy (one of <code>isolated</code> or <code>hoisted</code>)
+</ParamField>
+
 <ParamField path="--filter" type="string">
   Install packages for the matching workspaces
 </ParamField>
@@ -112,6 +121,18 @@ bun install <name>@<version>
   Recursively analyze & install all dependencies of files passed as arguments
 </ParamField>
 
+### Platform Targeting
+
+<ParamField path="--cpu" type="string">
+  Override CPU architecture for optional dependencies (e.g., <code>x64</code>, <code>arm64</code>, <code>*</code> for
+  all)
+</ParamField>
+
+<ParamField path="--os" type="string">
+  Override operating system for optional dependencies (e.g., <code>linux</code>, <code>darwin</code>, <code>*</code> for
+  all)
+</ParamField>
+
 ### Caching Options
 
 <ParamField path="--cache-dir" type="string">
@@ -150,6 +171,10 @@ bun install <name>@<version>
   Add to trustedDependencies in the project's package.json and install the package(s)
 </ParamField>
 
+<ParamField path="--minimum-release-age" type="number">
+  Only install package versions published at least this many seconds ago
+</ParamField>
+
 ### Concurrency & Performance
 
 <ParamField path="--concurrent-scripts" type="number">