Understanding file system access in CRHQ — what agents can read, write, and where files live.
CRHQ agents have full access to the server's file system. They can read, write, create, and manage files as part of their work.
Your CRHQ instance has several standard directories:
| Directory | Purpose | Access |
|---|---|---|
| uploads/ | User file uploads from sessions | Read-only for agents |
| public/downloads/ | Files served at public URLs | Read/write |
| .scratch/ | Temporary work — disposable | Read/write |
| documents/ | Working documents for active projects | Read/write |
| skills/ | Skill scripts and assets | Read (write for custom skills) |
Agents can read any file on the server. Common uses:
Agents can create and modify files. Common uses:
Files written to public/downloads/ are accessible via URL:
https://your-instance.crhq.ai/downloads/filename.ext
This is how agents share files externally — generate a report, save it to downloads, and share the URL.
The .scratch/ directory is for temporary work. Agents use it for:
Files here are disposable and may be cleaned up periodically.
There are two ways to get files to agents:
For large files or files that multiple sessions need, placing them on the file system is more efficient than uploading as attachments.