smolvm sandbox file

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

flag

Require parent directories to already exist instead of creating them.

string

Path to an SSH private key when the command uses SSH.

string

default:"root"

SSH user when the command uses SSH.

string

Host-to-guest control channel. Use ssh, vsock, or omit it for auto-selection.

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
}

Host mounts - Share a whole folder
smolvm sandbox env - Set config values
Control channel - Learn how file transfer chooses SSH or vsock

Last modified on June 24, 2026

⌘I

Celesto CLI

SmolVM API

SmolVM CLI

Agentor API

Synopsis

Shared options

Upload a file

Download a file

Use JSON output

​Synopsis

​Shared options

​Upload a file

​Download a file

​Use JSON output

​Related commands

Synopsis

Shared options

Upload a file

Download a file

Use JSON output

Related commands