File Organizer

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.

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 <source> <dest> - Single file
• find . -name "*.ext" -exec mv {} <dest>/ \; - 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)