Scan a Directory Before Moving

Preview all classifications for a folder without moving.

Basic Scan 

# Scan Downloads
uv run para-files scan ~/Downloads

# Scan recursively (subdirectories)
uv run para-files scan ~/Downloads --recursive

See Results

Shows each file and where it would go.

Useful For

  • Preview before big move operation
  • Check confidence levels
  • Find unclassifiable files
  • Get overview of what needs organizing

Options

Recursive Scan 

uv run para-files scan ~/Downloads --recursive

# Scans all subdirectories too

Filter by Extension 

uv run para-files scan ~/Downloads --ext .pdf

# Only PDFs

JSON Output 

uv run para-files scan ~/Downloads --json

# Shows statistics: file counts per category, etc.

Examples

Preview Downloads 

# What would happen to all my downloads?
uv run para-files scan ~/Downloads --recursive --json

# See how many go to each category

Find Problem Files 

# Which files might have issues?
uv run para-files scan ~/Downloads -v

# Verbose shows confidence for each

Workflow 

# 1. Scan to see what would happen
uv run para-files scan ~/Downloads --json

# 2. Review the output

# 3. If satisfied, move them
uv run para-files move ~/Downloads/*.pdf