docs(cli): say --upload cannot take a command (#4502)

Signed-off-by: Eric Curtin <eric.curtin@docker.com>
This commit is contained in:
Eric Curtin
2026-10-20 18:46:42 +00:00
committed by GitHub
parent 32f026442e
commit ea265a2f9a
4 changed files with 42 additions and 7 deletions
+6 -4
View File
@@ -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).