diff --git a/fern/.docs-snapshots.yml b/fern/.docs-snapshots.yml
index e96953854..549883454 100644
--- a/fern/.docs-snapshots.yml
+++ b/fern/.docs-snapshots.yml
@@ -1,8 +1,8 @@
 snapshots:
   dev:
-    source-ref: 32f026442e4d19ee51e34aa6e0bc7cfb27183362
-    source-sha: 32f026442e4d19ee51e34aa6e0bc7cfb27183362
-    version: 0.1.6.dev5
+    source-ref: ea265a2f9a86e6fc1911041fec4b5fdcefd674dd
+    source-sha: ea265a2f9a86e6fc1911041fec4b5fdcefd674dd
+    version: 0.1.6.dev6
   latest:
     source-ref: bdb956f2cd65a635f1294fccf1d138d263bf650f
     source-sha: bdb956f2cd65a635f1294fccf1d138d263bf650f
diff --git a/fern/pages-dev/how-it-works/sandboxes/overview.mdx b/fern/pages-dev/how-it-works/sandboxes/overview.mdx
index 5a8471803..430e90c92 100644
--- a/fern/pages-dev/how-it-works/sandboxes/overview.mdx
+++ b/fern/pages-dev/how-it-works/sandboxes/overview.mdx
@@ -946,10 +946,11 @@ directory are also accepted.
 <Note>
 You can also upload files at creation time with the `--upload` flag on
 `openshell sandbox create`. Pass `--upload` multiple times to upload
-several paths in a single command:
+several paths in a single command. You cannot add a trailing command, so run
+the workload from the shell that opens or with `sandbox exec`:
 
 ```shell
-openshell sandbox create --from registry.example.com/your-org/claude-agent:latest --upload ./src:/workspace/src --upload ./config:/workspace/config -- claude
+openshell sandbox create --from registry.example.com/your-org/claude-agent:latest --upload ./src:/workspace/src --upload ./config:/workspace/config
 ```
 
 </Note>
diff --git a/fern/pages-dev/tutorials/run-pi-with-openrouter.mdx b/fern/pages-dev/tutorials/run-pi-with-openrouter.mdx
index 4e57903f6..b53fc2a68 100644
--- a/fern/pages-dev/tutorials/run-pi-with-openrouter.mdx
+++ b/fern/pages-dev/tutorials/run-pi-with-openrouter.mdx
@@ -185,18 +185,20 @@ blocks. When you're done, type `/quit` in Pi to exit.
 ## Work on a Local Project
 
 To point Pi at your own code, run this from your project directory. `--upload`
-copies the directory into the sandbox before Pi starts, skipping anything
-`.gitignore` excludes.
+copies the directory into the sandbox, skipping anything `.gitignore` excludes.
+You cannot combine `--upload` with a trailing command, so start Pi from the
+shell that opens.
 
 ```shell
 openshell sandbox create \
   --name pi-project \
   --from pi-agent:local \
   --provider openrouter \
-  --upload .:/workspace \
-  -- pi
+  --upload .:/workspace
 ```
 
+In the sandbox shell, run `pi`.
+
 Pi's changes stay inside the sandbox. To copy them back, run
 `openshell sandbox download` from another terminal while Pi is still running.
 Refer to [Transfer Files](/how-it-works/sandboxes/overview#transfer-files).