claude-code-toolkit

# Cross-Platform File Organizer Toolkit

## Overview
This toolkit helps organize files across different operating systems using Python. It supports Windows, macOS, and Linux.

## Features
- Recursively scans directories
- Moves files based on file type
- Creates organized folder structure
- Logs all actions for review

## Usage
```python
import os
import shutil
import logging

# Configure logging
logging.basicConfig(filename='file_organizer.log', level=logging.INFO)

# Define target directories
directories = {
    'Documents': ['.pdf', '.docx', '.txt'],
    'Images': ['.jpg', '.png', '.gif'],
    'Videos': ['.mp4', '.mov', '.avi'],
    'Music': ['.mp3', '.wav', '.aac']
}

# Organize files
def organize_files(source_dir):
    for filename in os.listdir(source_dir):
        file_path = os.path.join(source_dir, filename)
        if os.path.isfile(file_path):
            file_ext = os.path.splitext(filename)[1].lower()
            for folder, extensions in directories.items():
                if file_ext in extensions:
                    target_dir = os.path.join(source_dir, folder)
                    os.makedirs(target_dir, exist_ok=True)
                    shutil.move(file_path, os.path.join(target_dir, filename))
                    logging.info(f'Moved {filename} to {folder}')
                    break

# Run the organizer
if __name__ == '__main__':
    source_directory = input('Enter the directory path to organize: ')
    organize_files(source_directory)
```

## Compatibility
- Windows 10/11
- macOS 10.15 and later
- Linux (Ubuntu, Fedora, Debian)

## Requirements
- Python 3.6 or later
- Basic file system permissions