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">