Local-first macOS maintenance

Maintenance App

A conservative, auditable workflow for cleanup, file organisation, and login-item review.

01

The problem

Maintenance scripts are fragmented and automated deletion can be difficult to review safely.

02

Approach

Use a SwiftUI app to read shared JSON reports and separate scans, safe actions, and human review.

03

Key engineering decisions

  • SwiftPM native application
  • Risky login items are report-only
  • launchd jobs retain logs and latest reports
04

Boundaries and limitations

  • The app uses local ad-hoc signing
  • System LaunchAgents and Daemons are never removed automatically