Skip to content
wataPublic

About

A Mac app that watches your own launchd jobs, cron jobs, Folder Actions and SwiftBar plugins, and notifies you the moment one breaks.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

22 Commits

Folders and files

Repository files navigation

Breaker

Breaker icon

A Mac app that watches the automations you built yourself — launchd jobs, cron jobs, Folder Actions, SwiftBar plugins — and notifies you the moment one breaks.

Scheduled scripts fail silently. Breaker was born after one of mine kept failing for weeks without anyone noticing.

Download the latest version — signed and notarized, with automatic updates.

Screenshot 1

Features

  • One list for everything you scheduled: launchd agents in ~/Library/LaunchAgents, your crontab, Folder Actions (AppleScript and Automator), SwiftBar plugins, and any apps you choose to keep running. Agents and daemons in /Library can be shown too, view only.
  • Catches failures exit codes miss: a job that exited with an error, isn't loaded, missed a scheduled run, points to a script or interpreter that no longer exists, or wrote an error to its log.
  • Notifications and a Dock badge when something breaks. Breaker keeps checking every 60 seconds after you close its window.
  • Fix it in place: run, stop, and resume launchd jobs, edit their schedules, and read stdout and stderr with the error lines highlighted.
  • Only your own jobs by default: jobs installed by other apps are hidden and never notified, so the list stays about what you control.
  • English and Japanese.

Requirements

macOS 26 or later.

Usage

Download the latest pre-built application binary from Releases page and move it to /Applications. Breaker checks for updates automatically, and you can also choose Check for Updates… from the app menu.

Or install it with Homebrew:

brew install --cask wata/tap/breaker

On first launch, Breaker asks for permission to send notifications and to control System Events (to read your Folder Actions).

Choose the apps to watch in Settings (⌘,). Use the filter in the sidebar to show launchd jobs installed by apps, or only items with issues.

Development

  • ./scripts/install.sh builds a Release build and replaces /Applications/Breaker.app with it (--no-launch to skip launching).
  • ./scripts/release.sh <version> [--notes <file>] bumps the version, builds a notarized zip, updates appcast.xml, and publishes a GitHub Release. Use --no-publish to stop before committing.
  • To build it yourself, change the Team under Signing & Capabilities to your own.
  • xcodebuild test -project Breaker.xcodeproj -scheme Breaker -destination 'platform=macOS' -derivedDataPath build/test runs the tests.
  • For screenshots, launch a Debug build with -BreakerSampleData YES to show sample items instead of your own, without touching the system or your settings.

License

MIT

About

A Mac app that watches your own launchd jobs, cron jobs, Folder Actions and SwiftBar plugins, and notifies you the moment one breaks.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages