reset-resurf

CLI tool to reset Resurf app data, permissions, and vault on macOS.

Installation

Global Installation

npm install -g reset-resurf

Using npx (No Installation Required)

npx reset-resurf --help

Usage

reset-resurf [--prod|--dev|--all] [options]

Options

• --prod - Reset production app (default)
• --dev - Reset development app
• --all - Reset both production and development apps
• --dry-run - Print what would be removed, but do nothing
• --yes, -y - Skip confirmation
• --wipe-vault - Also delete default vault folders in Documents/iCloud
• --wipe-vault-config - Delete vault config file (.config/vault.json) but keep vault contents
• --no-quit - Do not try to quit running Resurf app first
• --bundle-id <id> - Override bundle id (default: so.resurf.app / so.resurf.app.dev)
• --product-name <name> - Override product name (default: Resurf / Resurf Dev)
• --help, -h - Show help

Examples

# Dry run to see what would be deleted
reset-resurf --dry-run

# Reset production app without confirmation
reset-resurf --yes

# Reset development app
reset-resurf --dev --yes

# Reset both and wipe vault
reset-resurf --all --wipe-vault --yes

# Reset vault config only
reset-resurf --all --wipe-vault-config --yes

# Using npx
npx reset-resurf --help

What It Does

• Quits running Resurf app (if --no-quit is not specified)
• Resets macOS permissions (TCC) for the app
• Deletes app data directories:
  • Application Support
  • Caches
  • Logs
  • Preferences
  • Saved Application State
  • WebKit data
• Optionally deletes vault folders and/or vault config

Requirements

• macOS only
• Node.js 18+ (comes with npm/npx - no additional dependencies needed)

License

MIT