File Organizer

---

name: file-organizer description: "File organization and batch operations for workspace management. Use when organizing files for: (1) Moving files to correct directories, (2) Batch renaming (patterns, numbering, dates), (3) Creating directory structures, (4) Organizing by type/extension, (5) Cleaning scattered files, (6) Project scaffolding, or (7) Restructuring project layouts."

---

File Organizer

Manages file organization through safe, predictable batch operations.

Core Workflows

Directory Structure

Create standard project layouts:

project/
├── src/          - Source code
├── docs/         - Documentation
├── tests/        - Test files
├── assets/       - Images, fonts, media
├── scripts/      - Build scripts, utilities
└── config/       - Configuration files

Moving Files

mv - Single file

find . -name "*.ext" -exec mv {} / \; - Batch by extension

Always confirm destination exists

Batch Renaming

Patterns:

Sequential numbering: file_{001..100}.txt

Date-based: YYYY-MM-DD_description

Type-based: Group by extension

Safe approach: 1. echo commands first (dry run) 2. Review output 3. Remove echo, execute

Organizing by Type

Group files by extension into folders:

mkdir -p images docs code
find . -name "*.png" -o -name "*.jpg" | xargs -I {} mv {} images/
find . -name "*.md" -o -name "*.txt" | xargs -I {} mv {} docs/
find . -name "*.py" -o -name "*.js" | xargs -I {} mv {} code/

Finding Scattered Files

find . -type f -name "*.ext"    # Find by extension
find . -type f -mtime -7        # Modified in last 7 days
find . -type f -size +100M      # Large files

Dry Runs First

Always preview batch operations:

echo "Would move these files:"
find . -name "*.ext"
Review, then execute

Safety Rules

1. Never delete without explicit permission (use trash if available) 2. Dry run first - Always echo/preview batch operations 3. Check destinations - Confirm target directories exist 4. Backup before restructure - Snapshot before major moves 5. Respect workspace boundaries - Only touch ~/openclaw

When to Read references/patterns.md

Load when:

Complex rename patterns needed

Project structure templates required

Advanced find commands for filtering

Edge cases (symlinks, special characters)