Skip to content

README.md

Latest commit

 

History

History
79 lines (54 loc) · 2.62 KB

README.md

File metadata and controls

79 lines (54 loc) · 2.62 KB
Raw

Patchly icon

Patchly

Know what's out of date on your Mac, from the menu bar

Patchly

Patchly sits in the menu bar and scans every app in /Applications (plus /Applications/Utilities and ~/Applications), checking each one against the Mac App Store, Homebrew, or its own Sparkle update feed — whichever applies — and shows you which ones actually have an update waiting.

Requirements

  • macOS 26 (Tahoe) on Apple Silicon

Install

Build from source:

git clone https://github.com/mberrishdev/Patchly.git
cd Patchly
open Patchly.xcodeproj   # ⌘R

Or headless:

xcodebuild -project Patchly.xcodeproj -scheme Patchly -configuration Debug build

Run the tests the same way CI does:

xcodebuild test -project Patchly.xcodeproj -scheme Patchly -destination 'platform=macOS'

Or via Homebrew:

brew tap mberrishdev/patchly https://github.com/mberrishdev/Patchly
brew trust --tap mberrishdev/patchly
brew install --cask patchly

Using it

Click the menu bar icon to see the list. Apps with an update available sort to the top, with a badge count next to the icon so you don't even need to open it to know something's out of date. Click any app to reveal it in Finder. A manual Refresh button is always available; Patchly also refreshes automatically on a timer and whenever your Mac wakes from sleep.

Patchly reports update status — it does not install updates for you (yet). See CONTEXT.md for exactly why and how each app's status is determined.

Architecture

  • Patchly/App/ — composition root and app settings
  • Patchly/Scanner/ — app discovery and the three-source update aggregator
  • Patchly/UpdateSources/ — Mac App Store, Homebrew Cask, and Sparkle Feed checkers
  • Patchly/Support/, Patchly/Persistence/, Patchly/State/, Patchly/UI/

CONTEXT.md is the domain doc — binding terminology and behavior.

Roadmap

  1. Scaffold Xcode project + folder layout done
  2. Scanner + all three Update Sources + Aggregator, unit-tested independently
  3. Cache-first UI with manual/auto Refresh
  4. One-click update actions per source

License

MIT