Storage Management

Bossa provides a unified view of storage across your local SSD, iCloud Drive, and external drives.

Commands

bossa storage status      # Unified storage overview
bossa storage duplicates  # Find duplicates across locations

Storage Overview

Get a bird's-eye view of all storage:

bossa storage status

Output:

Storage Overview
================

Local SSD (500 GB)
  Used:      350 GB (70%)
  Available: 150 GB

  Top directories:
    ~/Library           45 GB
    ~/dev               80 GB
    ~/Downloads         12 GB

iCloud Drive (200 GB)
  Used:      120 GB (60%)
  Available:  80 GB
  Local:      45 GB (downloaded)
  Cloud:      75 GB (evicted)

External: T9 (/Volumes/T9)
  Used:      1.2 TB
  Available: 800 GB

  Top directories:
    /Volumes/T9/Backups    500 GB
    /Volumes/T9/Media      400 GB
    /Volumes/T9/Caches     300 GB

Finding Duplicates

Find duplicate files across storage locations:

bossa storage duplicates

This requires manifests to be scanned first:

# Scan locations to build manifests
bossa manifest scan ~/dev
bossa manifest scan ~/Library/Mobile\ Documents
bossa manifest scan /Volumes/External

# Then find duplicates
bossa storage duplicates

Output:

Duplicates Found: 15 files (2.3 GB total)

project-backup.zip (500 MB)
  ~/Downloads/project-backup.zip
  /Volumes/External/Backups/project-backup.zip

photo-2024.jpg (15 MB)
  ~/Pictures/photo-2024.jpg
  ~/Library/Mobile Documents/com~apple~CloudDocs/Photos/photo-2024.jpg

Cache Management

Move caches to external storage:

bossa caches status     # Show cache locations
bossa caches apply      # Apply cache config (create symlinks)
bossa caches audit      # Detect drift
bossa caches doctor     # Health checks
bossa caches init       # Create a starter config

iCloud Management

Control iCloud Drive downloads:

bossa icloud status     # Show iCloud space usage
bossa icloud download   # Download files from cloud
bossa icloud evict      # Evict files to free space

Manifest Operations

Build file manifests for duplicate detection:

bossa manifest scan <path>   # Hash files in directory
bossa manifest stats <path>  # Show manifest stats
bossa manifest duplicates <path>  # Find duplicates in manifest

Configuration

Cache Mappings

Define cache locations in ~/.config/bossa/caches.toml:

external_drive = { name = "T9", mount_point = "/Volumes/T9", base_path = "caches" }

[[symlinks]]
name = "homebrew"
source = "~/Library/Caches/Homebrew"
target = "homebrew"

[[symlinks]]
name = "cargo"
source = "~/.cargo/registry"
target = "cargo/registry"

Workflows

Free Up Local Space

Check storage status:
```
bossa storage status
```

Evict iCloud files:

bossa icloud evict ~/Library/Mobile\ Documents/large-folder/

Move caches to external:
```
bossa caches apply
```
Find and remove duplicates:
```
bossa storage duplicates
```

External Drive Setup

Create cache directories:

mkdir -p /Volumes/External/Caches/{Homebrew,cargo,npm}

Configure mappings in caches.toml
Move caches:
```
bossa caches apply
```
Verify:
```
bossa caches status
```

Tips

Scan regularly - Keep manifests up to date for accurate duplicate detection
Use external drives for caches - Keep SSD space for active work
Evict large iCloud folders - Download on demand
Check before deleting - Review duplicates carefully before removal

Bossa Documentation