Home
cd ../playbooks
File OrganizationBeginner

Old File Cleanup Assistant

Identify safely deletable old files with intelligent recommendations based on age, type, and usage patterns.

5 minutes
By communitySource
#cleanup#storage#old-files#organization#declutter

Your Downloads folder has 3,000 files going back to 2019. Your Documents folder has five versions of every file because you save 'final_v2_REAL_final.docx.' You know there's 50 GB of stuff you don't need but you're terrified of deleting the wrong thing.

Who it's for: anyone whose computer storage is running low from accumulated files, professionals with years of unorganized downloads and documents, developers with old project folders consuming disk space, office workers managing shared drives full of outdated files, people preparing to migrate to a new computer and wanting to clean up first

Example

"Clean up my Documents folder — it's 40 GB" → Categorized inventory of files by age and type, safe deletion recommendations for 15 GB of duplicates and temp files, flagged 3 GB of potentially important files for review, and cleanup script with dry-run option

CLAUDE.md Template

New here? 3-minute setup guide → | Already set up? Copy the template below.

# Old File Cleanup Assistant

## Your Role
You identify safely deletable old files with intelligent recommendations, considering age, file type, location, and usage patterns. You NEVER auto-delete.

## Cleanup Categories

### Safe to Delete (Low Risk)
- **Temp files**: .tmp, .temp, ~*, .DS_Store
- **Cache files**: Browser cache, app caches
- **Log files**: .log files older than 30 days
- **Download installers**: .dmg, .exe, .pkg after installation
- **Duplicate downloads**: file.pdf, file (1).pdf, file (2).pdf

### Review Recommended (Medium Risk)
- **Old downloads**: Files in Downloads/ older than 90 days
- **Old screenshots**: Screenshots older than 6 months
- **Large media**: Videos over 1GB not accessed in 1 year
- **Old archives**: .zip files older than 1 year

### Caution Required (Higher Risk)
- **Old documents**: .doc, .pdf older than 2 years
- **Old projects**: Folders not modified in 2+ years
- **Old backups**: Backup files older than current backup set

## Analysis Criteria

For each file, evaluate:
1. **Age** - When was it last modified/accessed?
2. **Type** - Is it recoverable (download) or unique (document)?
3. **Location** - Downloads vs Documents vs Projects
4. **Size** - Impact on storage
5. **Duplicates** - Does it exist elsewhere?

## Output Format

```markdown
# Cleanup Recommendations

## Quick Wins (Safe to Delete)
| Type | Count | Size | Example |
|------|-------|------|---------|
| Temp files | 234 | 1.2 GB | ~/.Trash, /tmp |
| Old installers | 12 | 4.5 GB | Downloads/*.dmg |
| Cache files | 1,420 | 3.2 GB | ~/Library/Caches |
| **Total** | **1,666** | **8.9 GB** | |

## Review These First
| File/Folder | Age | Size | Recommendation |
|-------------|-----|------|----------------|
| Downloads/old-project.zip | 2 years | 500 MB | Likely safe |
| Documents/report-2022.pdf | 3 years | 2 MB | Review content |

## Do Not Delete (Flagged as Important)
- ~/Documents/Tax-2023/ (financial records)
- ~/Projects/active-client/ (recent git activity)
```

## Age Thresholds

| File Type | Safe After | Review After |
|-----------|------------|--------------|
| Temp/Cache | Immediate | - |
| Downloads | 90 days | 30 days |
| Screenshots | 6 months | 3 months |
| Installers | After install | - |
| Documents | Never auto | 2 years |
| Projects | Never auto | 1 year |

## Smart Detection

### Files to PROTECT
- Anything in git repositories (active)
- Tax/financial documents (any age)
- Files with recent access (even if old)
- Unique files (no duplicates/backups)

### Files to FLAG
- Large files (> 100MB) not accessed in 1 year
- Folders with "old", "backup", "archive" in name
- Multiple versions of same document

## Instructions

1. Specify folder or "full system scan"
2. I'll analyze and categorize files
3. Review my recommendations by category
4. Approve specific deletions
5. I'll generate cleanup commands (you execute)

## Safety Rules

- NEVER delete without explicit approval
- Always show what will be deleted first
- Recommend Trash over permanent delete
- Exclude system files and app bundles
- Flag anything uncertain

## Commands

```
"What can I safely delete in Downloads?"
"Find old files I haven't touched in a year"
"How much space can I free up?"
"Show me large files I might not need"
```

Get new playbooks like this one

One email a week with new Claude Code workflows. Free, like everything here.

No spam. Unsubscribe anytime.

README.md

What This Does

Find old files you can safely delete - temp files, old downloads, unused installers, and more. Smart recommendations consider file age, type, and whether backups exist. Never deletes without your approval.


Quick Start

Step 1: Download the Template

Click Download above to get the CLAUDE.md file.

Step 2: Place in Home Folder

mv ~/Downloads/CLAUDE.md ~/

Step 3: Run Claude Code

cd ~
claude

Step 4: Start Cleanup

Say: "What old files can I safely delete?"


Safety Tiers

Tier Risk Level Examples
Safe to delete None .tmp, cache, .DS_Store
Review first Low Downloads 90+ days old
Caution Medium Old documents, projects
Protected N/A Tax docs, active projects

Example Output

## Quick Wins (Safe to Delete)
| Type | Count | Size |
|------|-------|------|
| Temp files | 234 | 1.2 GB |
| Old installers | 12 | 4.5 GB |
| Cache files | 1,420 | 3.2 GB |
| **Total** | **1,666** | **8.9 GB** |

## Review These
| File | Age | Size |
|------|-----|------|
| old-project.zip | 2 years | 500 MB |
| report-2022.pdf | 3 years | 2 MB |

What Gets Protected

  • Files in git repositories
  • Tax and financial documents
  • Recently accessed files (even if old)
  • Unique files with no backups

Tips

  • Start with Downloads: Biggest quick wins
  • Check installers: .dmg/.exe files after installation
  • Empty Trash: Often forgotten, can be huge
  • Review before delete: Always preview what's going

Commands

"What can I safely delete in Downloads?"
"Find files I haven't touched in a year"
"How much space can I free up?"
"Show me large old files"

Troubleshooting

Want to keep an old file Say: "Keep [filename], it's important"

Not finding enough Extend timeframe: "Find files older than 6 months"

Worried about deleting wrong thing Claude recommends Trash over permanent delete - you can recover

$Related Playbooks

File Organization

Screenshot Organizer

Organize thousands of screenshots by analyzing their visual content. Claude reads text in images to create meaningful names and categories.

5 minutes
Beginner
File Organization

Smart Downloads Organizer

Intelligently organize your Downloads folder by analyzing file content, not just extensions. Claude reads files to categorize them meaningfully.

5 minutes
Beginner
File Organization

PDF Watermark Tool

Add watermarks, page numbers, headers, and footers to PDFs

10 minutes
Intermediate
File Organization

Photo Organizer by Event

Organize photos by reading EXIF metadata and analyzing content to create Year > Month > Event folder structures automatically.

5 minutes
Beginner
File Organization

Project Inventory & Documentation

Analyze project folders to understand what each does, identify tech stacks, and create documented inventories.

10 minutes
Intermediate
File Organization

Smart OCR Document Scanner

Extract text from images, scanned documents, and handwritten notes in 100+ languages using PaddleOCR.

10 minutes
Intermediate
File Organization

Document Parser

Parse complex documents while preserving structure, tables, and figures using IBM's docling library.

10 minutes
Advanced
File Organization

Document Processing Pipeline

Chain document operations into reusable pipelines

10 minutes
Advanced
File Organization

Word Document Manipulation

Create, edit, and manipulate Word documents programmatically using python-docx

10 minutes
Advanced
File Organization

Business Analytics Reporter

Analyze sales and revenue data from CSV files to identify weak areas, generate statistical insights, and provide strategic improvement recommendations.

10 minutes
Intermediate
File Organization

Batch File Converter

Batch convert documents between multiple formats using a unified pipeline

10 minutes
Advanced
File Organization

Batch Document Processor

Process multiple documents in bulk with parallel execution

10 minutes
Beginner

Browse all File Organization playbooks →