Documentation Index
Fetch the complete documentation index at: https://docs.celesto.ai/llms.txt
Use this file to discover all available pages before exploring further.
Host mounts let a sandbox read files from your local machine without copying them. This is useful when an agent needs to explore a codebase or process data that already lives on your host.
By default, the host folder is read-only — the sandbox can read every file, but changes stay inside the sandbox and never touch the originals. If you need the sandbox to write back to the host, see writable mounts below.
CLI
Mount a directory when creating a sandbox:
smolvm create --mount ~/Projects/my-app
smolvm ssh my-sandbox
ls /workspace # your host files appear here
smolvm create --mount ~/Projects/my-app:/code --mount ~/data:/mnt/data
Python SDK
from smolvm import SmolVM
with SmolVM(mounts=["~/Projects/my-app"]) as vm:
result = vm.run("ls /workspace")
print(result.stdout)
with SmolVM(mounts=["~/Projects/my-app:/code", "~/data:/mnt/data"]) as vm:
result = vm.run("ls /code")
print(result.stdout)
Writable mounts
By default, mounts are read-only. Add --writable-mounts to let the sandbox write back to your host directories.
CLI
smolvm create --mount ~/Projects/my-app --writable-mounts
Python SDK
from smolvm import SmolVM
with SmolVM(mounts=["~/Projects/my-app"], writable_mounts=True) as vm:
vm.run("echo 'hello' > /workspace/new-file.txt")
# new-file.txt now exists on the host at ~/Projects/my-app/new-file.txt
Writable mounts give the sandbox full write access to the mounted host directories. Make sure you trust the code running inside the sandbox before enabling this flag.
