ToShop DocsFiles & Finder
Open, reveal, and operate on files — scoped to paths you grant access to.
ToShop's file tools work the way the Finder does: open a file with its default app, reveal it in Finder, or hand it to your agent as input. Direct file edits go through approval and show a diff before they're applied.
Built-in tools
open_path— Open a file or folder with the OS default handler.reveal_in_finder— Show a file in Finder.file_read— Read a file's contents into the task.file_write— Write output to a path you've allowed.
How scope works
Your agent doesn't have blanket file access. It works inside:
Paths you mention
"Summarize ~/Documents/Q3-supplier-quotes.pdf" implicitly authorizes a read of that file.
Persistent grants
Once you approve "any read under ~/Documents/suppliers/", future reads in that tree run automatically. Manage in Settings → Permissions.
Skill-declared scopes
A skill that needs a specific location (e.g. your store's product-photos folder) asks for it on install.
Anything outside those scopes prompts before it touches the disk.
Diffs before writes
For edits (modifying an existing file), your agent shows a Diff in chat before applying. You approve or reject. For new files, you see the full content first.
Common patterns
| Goal | What your agent does |
|---|---|
| "Summarize this supplier contract PDF" | open_path to read → text extraction → summary in chat |
| "Add a Returns section to my supplier playbook" | Read → propose Diff → on approve, write |
| "Where did I save that vendor invoice screenshot?" | List recent files in ~/Pictures/ and ~/Desktop/ |
Related
- System Tools — clipboard, screenshot, OCR for getting content in.
- Permissions — managing file-access rules.