BlogGuides

The Complete File Management Guide for Vox

·5 min read

Vox can manage files on your computer by voice — search, move, rename, organize, and clean up — all without opening a file manager. Here's the complete guide to file operations.

Search for files

Computer, find all PDF files in my Downloads folder.

Search Results
Found 23 PDF files in ~/Downloads:
invoice-march-2026.pdf (2.1 MB)
project-proposal-v2.pdf (890 KB)
tax-return-2025.pdf (1.4 MB)
research-paper-ai-safety.pdf (3.2 MB)
... and 19 more files

Organize by category

Computer, organize my Downloads folder — put invoices in a billing folder, documents in a docs folder, and images in a photos folder.

Vox — File Organization
list_directory — scanning ~/Downloads (47 files)Done
Categorizing files by type and content...Done
create_directory — ~/Downloads/BillingDone
move_file — moved 8 invoices to Billing/Done
create_directory — ~/Downloads/DocsDone
move_file — moved 15 documents to Docs/Done
create_directory — ~/Downloads/PhotosDone
move_file — moved 12 images to Photos/Done

Rename files

Computer, rename all the screenshots on my desktop to include today's date.

Rename Output
Renamed 5 files:
Screenshot 2026-03-01.png → screenshot-2026-03-15-1.png
Screenshot 2026-03-02.png → screenshot-2026-03-15-2.png
Screenshot 2026-03-03.png → screenshot-2026-03-15-3.png
Screenshot 2026-03-04.png → screenshot-2026-03-15-4.png
Screenshot 2026-03-05.png → screenshot-2026-03-15-5.png

Clean up duplicates

Computer, find duplicate files in my Documents folder and list them.

Vox compares file names and sizes to identify likely duplicates, then only deletes items when you explicitly ask it to.

Tip

Vox only deletes files when you explicitly ask. It also blocks unsafe paths (like system folders) and refuses to delete directories unless you request recursive removal.

File operations reference

  • search_files — Find files by name, type, or content
  • read_file — Read file contents for analysis
  • write_file — Create or update text files
  • move_file — Move or rename files
  • copy_file — Duplicate files to new locations
  • list_directory — List folder contents with details
  • create_directory — Create new folders
Note

All file operations execute locally on your machine. Vox uses platform-native automation and shell commands under the hood, running with the same permissions as your user account.


Voice-driven file management means you can organize, search, and clean up your filesystem without ever touching a file manager or terminal.

Put Vox to work on your computer.

Download Vox for Mac and start with the local setup flow.

Download for Mac

macOS · Apple Silicon & Intel