Organize my project folders
Let OpenHuman tidy, rename, and restructure a folder of files safely, inside a boundary you set, with every change gated by your approval.
Goal: point the assistant at a folder and have it clean it up (sort files, rename consistently, remove clutter) without letting it roam your whole disk or make changes you didn't see.
The core idea: the agent works inside a boundary you define, and any file change that isn't provably read-only is parked for your approval before it runs.
Prerequisites
OpenHuman set up. See Create my personal AI assistant.
A specific folder you want organized. Ideally, make a copy first if the contents are irreplaceable.
Privacy implications
File organizing is local. Reading, moving, and renaming files happens on your machine.
If you ask the agent to reason about file contents (e.g. "group these by topic"), it may send relevant snippets to the model to do that. Route inference to a local model if you want that reasoning on-device too.
The agent cannot touch system or credential folders (
~/.ssh,~/.gnupg,~/.aws, OS directories). Those are blocked outright regardless of settings.
Steps
1. Decide where the agent may act
By default the agent's read/write root is its projects area (by default ~/OpenHuman/projects), and it's confined there. It does not have ambient access to the rest of your disk. To let it work on a folder elsewhere, add that folder as a trusted root:
Open Settings β Agents β Agent access.
Add the target folder as a trusted root with read-write access.
Keep the boundary as tight as the task: grant the one folder, not your home directory.
2. Set the right autonomy tier
Supervised (recommended): the agent proposes each change and you approve moves/renames/deletes as they come.
Full: routine file writes run automatically. Still tighten the trusted root so "automatic" stays contained.
Leave the Approval Gate on. Deleting and moving files are state-changing actions, so they'll be parked for your yes/no.
3. Ask for the reorganization
Be concrete about the folder and the rules. For example:
"In my trusted
~/Documents/receiptsfolder, rename every file toYYYY-MM-DD-vendor.pdfbased on its contents, and move anything older than 2023 into anarchive/subfolder.""Group the loose files in this folder into subfolders by type, and show me the plan before doing anything."
4. Review each proposed action
When the agent wants to move, rename, or delete, an Approval Request card appears with the exact action. Approve one, Always allow a repetitive safe one, or Deny. You can also just type yes / no.
Success checks
Common failures
"I can't access that folder"
The folder isn't a trusted root, or workspace_only is confining the agent
Add it in Settings β Agents β Agent access as a read-write trusted root
It asks for approval on every single file
Supervised tier gates each write
Use Always allow for the specific safe tool, or narrow the request so there are fewer actions
It refuses to touch a path
The path is a blocked system/credential directory
That's by design; those paths are never accessible. Choose a normal working folder
It reorganized more than you wanted
The instruction was broad
Ask it to "show the plan first"; approve selectively
Recovery
Nothing runs without approval in Supervised tier. If a plan looks wrong, Deny and it doesn't happen.
Undo is manual. OpenHuman doesn't roll file operations back for you, so work on a copy of anything precious, or keep the folder under version control (e.g.
git) so you can revert.If the agent is doing too much, drop to Read-only in Agent access. It can still suggest a plan but can't change files.
See also
Approval Gate: exactly what gets parked and why.
Coder toolset: the filesystem/git tools the agent uses here.
Privacy & Security: workspace scoping and path hardening.
Last updated