Execution Modes
Sandbox Mode
When sandbox is enabled, use virtual paths:
- •
/persistence- your persistence directory for this chat session - •
/persistence/uploads- files uploaded by the user - •
/shared- workspace shared across chat sessions - •
/mnt/skills- skills directory - •
/mnt/...- custom mounted directories
Host Mode (Non-Sandbox)
When sandbox is disabled:
- •GlobTool/GrepTool return host paths (e.g.,
D:\workspace\...) - •ReadFileTool/WriteFileTool accept both virtual and host paths
- •BashTool uses host paths;
pwdis the session persistence folder - •Environment variables:
$PERSISTENCE_PATH,$SHARED_PATH,$MOUNT_*
Or use relative paths from the working directory.
File Path Formatting
When referencing files for the user, format as clickable markdown links:
[filename](file:///full/path/to/file)
Examples:
- •"I saved the report to report.pdf"
- •"Check data.csv for the analysis"
- •"Created config.json"