Intelligently organizes your files and folders across your computer by understanding context, finding duplicates, suggesting better structures, and automating cleanup tasks. Reduces cognitive load and keeps your digital workspace tidy without manual effort.
Systematic file organization for macOS and Linux. Analyze → categorize → plan → confirm → execute → verify. Every destructive operation requires explicit user approval.
First step: Detect the platform (uname -s) and use the matching command variants from commands-reference.md. If a required tool is missing, stop and explain — never guess.
When NOT to use:
~/Library/ on macOS, ~/.local/share/ on Linux)| Phase | Action | Key Rule |
|-------|--------|----------|
| Scope | Ask: which directory, what problem, what to avoid, how aggressive | Never assume — always confirm scope |
| Detect | Run uname -s to determine macOS vs Linux | Use matching command variants from reference |
| Analyze | Survey file types, sizes, dates using safe read-only commands | See commands-reference.md for platform-specific commands |
| Categorize | Group by type, purpose, or date | Match user's mental model, not yours |
| Plan | Present tree diagram + change list + "needs decision" bucket | User must approve before any changes |
| Execute | mkdir -p then mv with logging | One category at a time; stop on conflicts |
| Verify | Show before/after summary + maintenance tips | Confirm nothing was lost |
mv, rm, or rename operation.git/, .dotfiles/, node_modules/, bare repo metadatafind -x (macOS) or find -xdev (Linux) to prevent scanning mounted volumes, network shares, or backup treesfile/md5/cat can trigger downloads of iCloud-evicted files. Check for dataless stubs first.mv (preserves by default) or cp -p when copyingdu * and ls * skip hidden files; find includes them. Be consistent.~/.dotfiles and similar GIT_DIR setups look like junk but are critical infrastructure| Mistake | Fix |
|---------|-----|
| Using GNU-only find -printf on macOS | BSD find has no -printf. Use stat or -exec basename. See commands-reference.md |
| Scanning without filesystem boundary flag | Accidentally includes mounted volumes and backups. Always use -x (macOS) or -xdev (Linux) |
| Wrong md5/md5sum pipeline for dedup | macOS uses md5 -r, Linux uses md5sum. Output format differs — see reference for correct awk pipeline |
| Deleting "duplicates" that are hardlinks | Check inodes first — see hardlink check in reference |
| Running du -sh * for size survey | Misses hidden directories. Use du -shx .[!.]* * or explicit find |
| Organizing inside app data dirs | ~/Library/ (macOS) and ~/.local/share/ (Linux) — reorganizing breaks apps |
| Moving cloud-synced files without warning | Triggers re-sync; can delete across devices if not careful |
commands-reference.md — platform-aware commands for analysis, duplicate detection, and organization. Shows macOS/Linux variants where they differ, portable commands where they don't.Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks OpenClaw to add a note, list notes, search notes, or manage note folders.
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Use when you need to control Slack from OpenClaw via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.
Manage Apple Reminders via remindctl CLI (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.
Manage Trello boards, lists, and cards via the Trello REST API.
Category:productivity