# File Organizer

> Professional file organization tool. Supports smart sorting by extension or date, SHA-256 deduplication, recursive scanning, and safety features like dry runs and undo capabilities.

- Skill: `1999azzar/file-organizer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add 1999azzar/file-organizer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/1999azzar/file-organizer/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: 1999AZZAR (https://skillmd.com/u/1999azzar)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/1999azzar/file-organizer

---


# File Organizer (Professional Edition)

## Features
- **Smart Sorting**: Group by Extension (Default) or Date (Year/Month).
- **Deduplication**: Identify and remove identical files based on SHA-256 fingerprinting to optimize storage.
- **Smart Ignore**: Automatically skips development and system directories (`.git`, `node_modules`, `venv`, etc.) and supports custom `.organizeignore` files.
- **Safety**: Includes Conflict Resolution (auto-rename), Dry Run simulation, and Undo capabilities.
- **Recursive Clean**: Deep scanning with intelligent directory pruning.
- **Audit Logging**: Generates `organize_history.json` for precise operation tracking.

## Usage

### Basic Sort (by Extension)
```bash
python3 scripts/organize.py /path/to/folder
```

### Date Sort (Year/Month)
```bash
python3 scripts/organize.py /path/to/folder --date
```

### Recursive Clean with Deduplication
```bash
python3 scripts/organize.py /path/to/folder --recursive --deduplicate
```

### Dry Run (Simulate)
```bash
python3 scripts/organize.py /path/to/folder --dry-run
```

### Undo
Revert changes using the history file (Note: deleted duplicates cannot be restored).
```bash
python3 scripts/organize.py --undo /path/to/folder/organize_history.json
```

## Reference Materials
- [File Categories](references/categories.md) - Mapping of file extensions to zones.