Skip to main content
smolvm sandbox file copies individual files between your host and a sandbox. Use it when you need to send a prompt, collect an artifact, or avoid sharing a whole folder.

​
Synopsis

smolvm sandbox file upload <sandbox> <local-path> <guest-path> [OPTIONS]
smolvm sandbox file download <sandbox> <guest-path> <local-path> [OPTIONS]

​
Shared options

​
--no-create-dirs
flag
Require parent directories to already exist instead of creating them.
​
--ssh-key
string
Path to an SSH private key when the command uses SSH.
​
--ssh-user
string
default:"root"
SSH user when the command uses SSH.
​
--comm-channel
string
Host-to-guest control channel. Use ssh, vsock, or omit it for auto-selection.
​
--json
flag
Print a JSON envelope instead of formatted text.

​
Upload a file

smolvm sandbox file upload my-sandbox ./prompt.txt /workspace/prompt.txt
Force the guest-agent channel on a recent Linux sandbox: 
smolvm sandbox file upload my-sandbox ./report.csv /workspace/report.csv --comm-channel vsock

​
Download a file

smolvm sandbox file download my-sandbox /workspace/result.json ./result.json

​
Use JSON output

smolvm sandbox file upload my-sandbox ./input.txt /tmp/input.txt --json

{
  "ok": true,
  "command": "sandbox.file.upload",
  "exit_code": 0,
  "data": {
    "vm_id": "my-sandbox",
    "local_path": "input.txt",
    "guest_path": "/tmp/input.txt"
  },
  "error": null
}
Last modified on June 24, 2026