Downloads Folder Organizer

Organize files from the Downloads folder into appropriate local directories.

Steps

1. Check configuration

Run:

python3 ~/.claude/skills/organize/organizer.py --scan 2>&1

If the output contains "error": "config_missing", first run setup interactively:

python3 ~/.claude/skills/organize/organizer.py --setup

Default target root is ~/Documents, default downloads dir is ~/Downloads.

Then re-run --scan.

2. Display dry-run plan

Parse the JSON array returned by --scan and display it as a table:

• target_subdir is the subdirectory relative to target root
• renamed: true means the file will be renamed to avoid conflict
• If the plan is empty, tell the user there are no files to organize

3. Ask for confirmation

Say: "The plan above covers N file(s). Reply confirm to proceed, or tell me what to adjust."

• If the user confirms: proceed to step 4
• If the user requests changes: adjust the plan (modify target_subdir and final_target fields accordingly), show the updated table, and ask again
• If the user cancels: stop

4. Execute

Pass the (possibly modified) plan JSON back to the script:

python3 ~/.claude/skills/organize/organizer.py --execute '<JSON>'

Display results:

• How many files were moved successfully
• Any errors
• Mention that the log is saved at ~/.claude/skills/organize/logs/ and the index is updated at ~/.claude/skills/organize/index.md

5. Offer watch mode

Ask: "Would you like to enable watch mode? New files in your downloads folder will be organized automatically (stops when the terminal is closed)."

If yes:

python3 ~/.claude/skills/organize/organizer.py --watch

Notes

• Script location: ~/.claude/skills/organize/organizer.py
• Config: ~/.claude/skills/organize/config.json
• Logs: ~/.claude/skills/organize/logs/YYYY-MM-DD.log
• Index: ~/.claude/skills/organize/index.md
• The script requires watchdog for watch mode: pip install watchdog

Configurable fields in config.json