Digital Declutter Agent

A comprehensive digital audit agent that conducts a full inventory of your digital life — unused apps, forgotten subscriptions, duplicate files, stale cloud storage, dormant online accounts, and notification overload — then provides prioritized cleanup actions with estimated time and savings for each. Works conversationally to walk you through each category at your pace.

Supported Platforms & Integrations

Platform	Setup Method	Auth Type	Notes
macOS Applications	System scan	Local	Lists installed apps with last-used dates
iOS App Library	Screen Time export	Local file	Identifies unused apps by usage frequency
Google Drive	OAuth2	Google SSO	Scans for duplicates, old files, and storage hogs
Dropbox	API key	Bearer token	Finds abandoned shared folders and large files
Gmail	IMAP or OAuth2	App password	Identifies newsletter subscriptions and mailing lists
Bank Statements	CSV import	Local file	Detects recurring subscription charges

When to Use This Agent

• Use this when you receive a storage full notification and need to reclaim space urgently
• Use this when you check your bank statement and see charges you do not recognize
• Use this when your phone has 200+ apps but you use fewer than 30 regularly
• Use this when you have accounts on websites you have not visited in years and worry about data exposure
• Use this when digital clutter is causing low-grade anxiety and you want a clean slate
• Use this quarterly as preventive maintenance before clutter accumulates again
• Consider alternatives when you need enterprise-level IT asset management — this is for personal digital life
• Consider alternatives when you need malware scanning — use dedicated security software

Agent Persona

You are a methodical and encouraging digital organizer. You approach clutter without judgment — everyone accumulates digital mess. You present findings clearly with specific numbers (file counts, dollar amounts, storage sizes) and always let the user decide what to keep or remove. You never delete anything without explicit confirmation. Your tone is practical and efficient: identify the problem, present the fix, ask for the go-ahead.

Quick Start

Copy
# ~/.claude/agents/digital-declutter-agent.yaml
audit_areas:
  - installed_apps
  - cloud_storage
  - subscriptions
  - email_subscriptions
  - duplicate_files
  - old_accounts
cloud_providers:
  - google_drive
  - dropbox
bank_statement_path: ~/Finance/statements/
inactivity_threshold_days: 90
storage_alert_threshold_gb: 1
history_file: ~/.digital-declutter/audit_history.json

First Run Example

Copy
claude agent digital-declutter-agent --full-audit

Expected Output

Digital Declutter Agent — Full Audit
======================================

I will walk you through 6 areas of your digital life.
Each area gets a health score and specific cleanup actions.
Nothing gets deleted without your say-so.

AREA 1: INSTALLED APPS
  macOS applications scanned: 124
  Not opened in 90+ days: 34
  Not opened in 1 year+: 12
  Storage used by unused apps: 8.4 GB

  Top space wasters (unused):
    1. GarageBand — 1.8 GB (last opened: never)
    2. iMovie — 2.9 GB (last opened: 14 months ago)
    3. Xcode (old version) — 12.4 GB (superseded by newer install)

  Want me to list all 34 unused apps for review? (y/n)
  > y
  [lists all 34 with last-opened date and size]

  Actions available:
    - Move to Trash: select individual apps
    - Bulk remove: all apps unused for 1+ year (12 apps, 18.2 GB)
    - Skip: move to next area

AREA 2: CLOUD STORAGE
  Google Drive: 13.8 GB of 15 GB used (92%)
  Dropbox: 1.2 GB of 2 GB used (60%)

  Google Drive findings:
    - Duplicate files: 847 files (1.6 GB)
    - Files older than 2 years: 2,340 files (4.2 GB)
    - Shared files (link expired): 23 files
    - Large files (>100 MB): 8 files (3.1 GB)

  Recommended actions:
    1. Remove 847 duplicates (saves 1.6 GB) — 92% back to 81%
    2. Archive 8 large files to local backup (saves 3.1 GB)
    3. Review 2,340 old files in batches

AREA 3: PAID SUBSCRIPTIONS
  [scans bank statements]
  Recurring charges found: 16 subscriptions
  Total monthly cost: $142.87
  Total annual cost: $1,714.44

  Flagged as potentially unused:
    - Headspace: $12.99/mo (last app open: 67 days ago)
    - Adobe Creative Cloud: $54.99/mo (used Photoshop once in 3 months)
    - Coursera Plus: $49/mo (no course activity in 45 days)

  Potential monthly savings: $116.98
  Potential annual savings: $1,403.76

... (continues through areas 4-6) ...

AUDIT SUMMARY
  Apps: 34 unused (18.2 GB recoverable)
  Cloud: 5.3 GB recoverable on Google Drive
  Subscriptions: $117/mo potential savings
  Email lists: 28 newsletters to unsubscribe from
  Duplicates: 847 files across cloud storage
  Old accounts: 8 identified for closure

  Total potential savings: $1,404/year + 23.5 GB storage
  Estimated cleanup time: 2-3 hours (can be spread across sessions)

Want to start cleaning up? I can walk you through each action.

Conversation Flow

Audit Start
    |
    v
Area 1: Installed Apps -----> Scan + findings + actions
    |     (user approves/skips each action)
    v
Area 2: Cloud Storage ------> Scan + duplicates + old files
    |     (user reviews and confirms deletions)
    v
Area 3: Paid Subscriptions --> Bank scan + cost analysis
    |     (user decides which to cancel)
    v
Area 4: Email Subscriptions -> Newsletter audit
    |     (unsubscribe links provided)
    v
Area 5: Duplicate Files -----> Cross-platform scan
    |     (user picks which copies to keep)
    v
Area 6: Old Accounts --------> Identifies dormant accounts
    |     (data export + deletion guidance)
    v
Audit Summary + Savings Report

Advanced Configuration

Platform-Specific Setup

Google Drive Deep Scan

Copy
google_drive:
  enabled: true
  scan_shared_with_me: true
  scan_trash: true
  duplicate_detection: content_hash
  flag_older_than_years: 2
  ignore_folders:
    - "Tax Returns"
    - "Legal Documents"
  large_file_threshold_mb: 100

Subscription Detection

Copy
subscriptions:
  bank_statement_path: ~/Finance/statements/
  statement_format: csv
  lookback_months: 3
  known_subscriptions:
    - name: "Netflix"
      monthly_cost: 15.49
      essential: true
    - name: "Spotify"
      monthly_cost: 10.99
      essential: true
  flag_unused_threshold_days: 60

Full Options Reference

Parameter	Type	Default	Description
audit_areas	list	all 6	Which areas to include in the audit
cloud_providers	list	[]	Cloud storage services to scan
bank_statement_path	string	none	Path to bank statement exports
inactivity_threshold_days	int	90	Days without use before flagging apps
storage_alert_threshold_gb	float	1	Minimum size to flag as space waster
history_file	string	~/.digital-declutter/audit_history.json	Audit history path
dry_run	bool	true	Preview all actions before executing
batch_mode	bool	false	Group similar actions for faster processing
export_report	string	none	markdown, csv, or notion for the audit report
schedule_frequency	string	quarterly	How often to run the full audit
quick_scan	bool	false	Run a fast scan (apps + storage only)
include_cost_projection	bool	true	Project annual savings from subscription cuts

Core Concepts

Concept	Purpose	How It Works
Multi-Area Audit	Comprehensive digital hygiene	Scans six distinct categories for a complete picture
Inactivity Detection	Finds truly unused items	Cross-references last-opened dates, login history, and usage metrics
Cost Analysis	Quantifies waste in dollars	Converts forgotten subscriptions into monthly and annual dollar amounts
Safe Deletion	Prevents accidental loss	Always previews, always confirms, optionally backs up before removing
Progress Tracking	Shows cumulative cleanup impact	Logs storage recovered, money saved, and accounts closed over time

Architecture

Audit Trigger (manual or scheduled)
        |
        v
+-------------------+
| Area Scanner      |----> Scans each category in sequence
+-------------------+
        |
    +---+---+---+---+---+---+
    |   |   |   |   |   |   |
    v   v   v   v   v   v   v
  Apps Cloud Subs Email Dupes Accounts
    |   |   |   |   |   |   |
    +---+---+---+---+---+---+
        |
        v
+-------------------+
| Findings Presenter|<----> User (review + confirm per action)
+-------------------+
        |
        v
+-------------------+     +------------------+
| Action Executor   |---->| Progress Logger  |
| (with confirmation)|     | (savings + space)|
+-------------------+     +------------------+

Workflow Examples

Scenario 1: Emergency Storage Recovery

Input: iPhone showing "Storage Almost Full" with 256 GB device

Conversation:
  Agent runs quick scan focused on storage-heavy items
  Finds: 42 GB in cached podcast episodes, 18 GB in old photos
  already backed up to iCloud, 8 GB in apps not used in 6+ months

Output:
  Quick Recovery Actions (total: 68 GB):
  1. Clear podcast cache: 42 GB (re-downloads on demand)
  2. Remove local copies of backed-up photos: 18 GB
  3. Delete 12 unused apps: 8 GB
  All actions reversible — podcasts re-download, photos stay in iCloud
  Estimated time: 10 minutes

Scenario 2: Annual Account Cleanup

Input: User wants to close accounts on services they no longer use

Conversation:
  Agent reviews saved passwords (from exported CSV) for dormant accounts
  Identifies 23 accounts with no login in 12+ months
  Categorizes by data risk: high (financial), medium (social), low (misc)

Output:
  Account Cleanup Plan:
  High priority (close first, contains sensitive data):
    - Old bank account portal (export statements first)
    - Inactive crypto exchange (withdraw any balance)
  Medium priority (personal data exposure):
    - MyFitnessPal (export data, then delete)
    - Quora (delete account — data breach history)
    - Pinterest (export boards, then delete)
  Low priority (minimal data):
    - Random forum accounts (8 total, request deletion)
  For each: Data export link, deletion process, estimated time

Scenario 3: Quarterly Maintenance Check

Input: Running 3-month follow-up after initial full audit

Processing:
  - Compares current state to last audit
  - Identifies new clutter accumulated since cleanup
  - Calculates drift rate (how fast clutter returns)

Output:
  Quarterly Comparison:
  Storage reclaimed in initial audit: 23.5 GB
  Current new clutter since then: 4.2 GB (3 months)
  Clutter rate: ~1.4 GB/month
  New unused apps installed: 6 (5 not opened after first week)
  New subscriptions: 2 ($24.98/month added)
  Recommendation: Delete 6 unused apps (2.1 GB), evaluate 2 new
  subscriptions after 30-day trial period before committing

Best Practices

1. Run the full audit quarterly, not just when storage is full — Preventive maintenance takes 30 minutes. Emergency cleanup when your phone or cloud is full takes hours and leads to rushed decisions about what to keep.

2. Export data before closing any account — Every service has a data export option (GDPR requires it). Download your data from any account before requesting deletion so you never lose something irreplaceable.

3. Track subscription costs monthly, not just during audits — A $10/month subscription seems small until you realize it costs $120/year. The agent calculates annual projections to make the true cost visible.

4. Keep a small "do not delete" list in your config — Mark essential subscriptions and important folders in the config so the agent never flags them. This speeds up future audits and prevents accidental suggestions to delete things you need.

5. Involve the agent in new installs and signups — Before adding a new app or subscription, check if you already have something that serves the same purpose. The agent can compare your existing tools against the proposed new one.

Common Issues

1. macOS app last-opened date is inaccurate — System updates sometimes reset the last-opened timestamp. Cross-reference with your own memory and check application support folders for recent data if the date seems wrong.

2. Bank CSV does not parse correctly — Different banks use different CSV formats. Use the statement_format option to specify your bank, or export in OFX format which has more standardized parsing.

3. Duplicate detection finds false positives — Files with identical names but different content may be flagged. The agent uses content hashing by default, but enable manual_review_duplicates: true to review each pair before deletion.

Privacy & Data Handling

All scanning and analysis happens locally on your machine. File metadata, app usage data, and subscription information are stored in ~/.digital-declutter/audit_history.json and never transmitted externally. Bank statement CSVs are read in memory and not cached or copied. Cloud storage scanning uses your own API credentials with read-only access — no files are deleted without your explicit confirmation in the conversation. Password export files are read once for account identification and immediately discarded from memory. You can delete all audit history by removing the ~/.digital-declutter/ directory at any time.