Sandbox Commands

The codebase lives on a remote sandbox. All file operations and shell commands go through schema0 sandbox exec. Deployment uses schema0 sandbox deploy.

Command Summary

File Operations

Use dedicated file commands instead of sandbox exec "cat ...":

schema0 sandbox read packages/db/src/schema/tasks.ts        # read a file
schema0 sandbox write packages/db/src/schema/tasks.ts       # write (reads from stdin)
schema0 sandbox write path/to/file --content "file content"  # write inline
schema0 sandbox ls packages/db/src/schema                    # list directory tree
schema0 sandbox ls -L 2                                      # limit tree depth
schema0 sandbox grep "createDb" --path packages --include "*.ts"  # search

Relative paths resolve against the project root. Use these commands for all file reads, writes, and searches — they are faster and more reliable than sandbox exec "cat ...".

Key Notes

• sandbox deploy handles all builds and migrations internally -- do NOT run build or migrate commands manually before deploying
• sandbox exec max timeout is 300000 (5 minutes), default 30000
• The sandbox filesystem persists between commands
• Integrations use natural language search: schema0 integrations search gmail "send email"

References

• references/sandbox-files.md -- sandbox read/write/ls/grep (single-path, not the local Read tool)
• references/sandbox-exec.md -- sandbox exec syntax, options, common patterns
• references/sandbox-deploy.md -- sandbox deploy options, what it does per platform, notes
• references/version-management.md -- version list/preview/deploy/remove/confirm-migration workflow