explaingit

jcranokc/app-monitor

Analysis updated 2026-05-18

151SwiftAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A local-first macOS dashboard that tracks app usage, scans storage, checks for updates, and plans safe uninstalls.

Mindmap

mindmap
  root((App Monitor))
    What it does
      Tracks app usage
      Scans app storage
      Checks for updates
      Plans safe uninstalls
    Tech stack
      Swift
      SwiftUI
      SQLite
    Use cases
      Review usage trends
      Queue cleanup candidates
      Check update status
    Audience
      Mac users
      Power users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

See how much time is spent in each app with daily trends, top apps, and usage heatmaps.

USE CASE 2

Find storage hogging app files like caches and old bundles and safely queue them for cleanup.

USE CASE 3

Check whether installed apps have pending updates across the App Store, Homebrew, and Sparkle feeds.

What is it built with?

SwiftSwiftUISQLite

How does it compare?

jcranokc/app-monitorkunkka19xx/lookarinltte/latte
Stars151136174
LanguageSwiftSwiftSwift
Setup difficultyeasyeasyeasy
Complexity2/52/51/5
Audiencegeneralgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Building from source instead of using the Homebrew cask needs Xcode command line tools with Swift 5.9 support.

Free to use, modify, and distribute, including commercially, as long as the copyright notice is kept.

In plain English

App Monitor is a native macOS application that gives users one dashboard for understanding how apps on their Mac are used, how much storage they take up, whether they need cleanup, whether updates are available, and what would happen if they were uninstalled. It runs locally and stores its data on the user's own machine rather than sending anything to a remote server. The app is built with SwiftUI and uses a small SQLite database as its core. It tracks foreground app usage, pausing when the computer is idle, and turns that history into totals, daily trends, top apps, heatmaps, and a session timeline. It can also import past usage information from Spotlight, such as when an app was last opened and how many days it has been used. For storage, App Monitor scans installed app bundles along with related files such as caches, containers, preferences, logs, cookies, and diagnostic data. When it finds files worth reviewing, it does not delete them right away. Instead it uses a quarantine step: the user previews the exact paths, approves only the items they want removed, and can restore anything from history before it is gone for good. The app also checks app health, including code signing status, Gatekeeper approval, and stale or crash prone bundles, and it checks for updates across the Mac App Store, Homebrew, Apple software updates, and Sparkle based direct downloads. Compared to other tools in this space, App Monitor's angle is combining several jobs that are usually handled by separate apps: usage tracking, storage scanning, update checking, and uninstall planning, all reviewed together instead of applied blindly. It is not meant to replace a package manager or a malware scanner. Requirements are macOS 14 or newer and Xcode command line tools with Swift 5.9 support. It can be installed through a Homebrew cask beta, or built and run directly from source using the Swift package tools included in the repository. The project is released under the MIT License.

Copy-paste prompts

Prompt 1
Show me how to install the App Monitor Homebrew beta cask on my Mac.
Prompt 2
Explain how App Monitor's quarantine review works before it moves files to Trash.
Prompt 3
Walk me through building and running App Monitor from source with the Swift package tools.
Prompt 4
What does App Monitor check when it reports an app's health, like code signing and Gatekeeper status?

Frequently asked questions

What is app-monitor?

A local-first macOS dashboard that tracks app usage, scans storage, checks for updates, and plans safe uninstalls.

What language is app-monitor written in?

Mainly Swift. The stack also includes Swift, SwiftUI, SQLite.

What license does app-monitor use?

Free to use, modify, and distribute, including commercially, as long as the copyright notice is kept.

How hard is app-monitor to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is app-monitor for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.