[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-93250":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":13,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":16,"rankGlobal":9,"rankLanguage":9,"license":17,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":18,"topics":21,"createdAt":9,"pushedAt":9,"updatedAt":29,"readmeContent":30,"aiSummary":31,"trendingCount":14,"starSnapshotCount":14,"syncStatus":13,"lastSyncTime":32,"discoverSource":33},93250,"app-monitor","jcranokc\u002Fapp-monitor","jcranokc","Local-first macOS app usage, storage, cleanup, update, and uninstall monitor.",null,"Swift",115,4,2,0,5,43.6,"MIT License",false,"main",true,[22,23,24,25,26,27,28],"app-cleanup","local-first","macos","sqlite","swift","swiftui","usage-tracking","2026-07-22 04:02:08","# App Monitor\n\nApp Monitor is a local-first macOS utility for understanding application usage, storage, cleanup opportunities, update status, and uninstall impact from one native SwiftUI dashboard.\n\nThe app is built as a Swift Package executable with a lightweight SQLite-backed core. It runs as a standard macOS app with an optional menu bar presence.\n\n## Screenshots\n\n![App Monitor overview dashboard](docs\u002Fassets\u002Fapp-monitor-overview.png)\n\n| Usage Trends | Activity Timeline |\n| --- | --- |\n| ![Usage trends dashboard](docs\u002Fassets\u002Fapp-monitor-usage-trends.png) | ![Activity timeline dashboard](docs\u002Fassets\u002Fapp-monitor-activity-timeline.png) |\n\n| Warnings | Updates |\n| --- | --- |\n| ![Warnings dashboard](docs\u002Fassets\u002Fapp-monitor-warnings.png) | ![Updates dashboard](docs\u002Fassets\u002Fapp-monitor-updates.png) |\n\n| Quarantine Review | History |\n| --- | --- |\n| ![Cleanup suggestions dashboard](docs\u002Fassets\u002Fapp-monitor-cleanup-suggestions.png) | ![History dashboard](docs\u002Fassets\u002Fapp-monitor-history.png) |\n\n## Features\n\n- App inventory across common macOS application locations, with optional broader bundle discovery.\n- Foreground app usage tracking with idle\u002Fsession pause handling.\n- Usage analytics for totals, daily trends, top apps, heatmaps, and timeline sessions.\n- Spotlight usage import for historical last-used dates, use counts, and used days.\n- Storage scans for app bundles and related Application Support, cache, container, preference, log, WebKit, cookie, and diagnostic paths.\n- Quarantine review with exact-path preview, queued approval, restore, and action history flows.\n- Large-file review and warning surfaces.\n- App health checks for code signing, Gatekeeper, stale bundles, crashes, and permission-sensitive paths.\n- Update checks for Mac App Store apps, Homebrew casks\u002Fformulae, Apple software updates, and direct-download apps with Sparkle feeds.\n- Guided uninstall planning that moves selected app and support files to Trash.\n- CSV exports for app tables, daily usage, timeline sessions, summaries, trend buckets, top apps, and heatmaps.\n\n## How It Compares\n\nApp Monitor is meant to sit between usage trackers, cleanup tools, update checkers, and uninstall helpers:\n\n- Compared with pure usage trackers, it keeps local foreground usage history alongside app storage and health context.\n- Compared with cleaner apps, it defaults to review and quarantine instead of permanent deletion.\n- Compared with uninstall tools, it shows an uninstall plan and affected paths before moving selected items to Trash.\n- Compared with update checkers, it combines Mac App Store, Homebrew, Apple software update, and Sparkle\u002Fdirect-download signals in one local view.\n\nThis category is crowded, so App Monitor's niche is the combination: usage history explains whether an app still matters, storage scans show what it owns, warnings flag review-worthy risk, updates show maintenance status, and quarantine-first cleanup keeps changes reversible. It is not trying to replace dedicated package managers, malware scanners, or deep disk visualizers. The goal is a native, local-first dashboard that makes app-related usage, storage, warnings, cleanup candidates, updates, and uninstall impact easier to inspect together.\n\n## Requirements\n\n- macOS 14 or newer.\n- Xcode command line tools or Xcode with Swift 5.9 support.\n- Optional: Homebrew and `mas` for Homebrew and Mac App Store update checks.\n\n## Install Beta\n\nInstall the current Homebrew beta with:\n\n```bash\nbrew install --cask jcranokc\u002Ftap\u002Fapp-monitor@beta\n```\n\nOr tap first, then install:\n\n```bash\nbrew tap jcranokc\u002Ftap\nbrew install --cask app-monitor@beta\n```\n\nThe tap lives at [jcranokc\u002Fhomebrew-tap](https:\u002F\u002Fgithub.com\u002Fjcranokc\u002Fhomebrew-tap).\n\n## Build And Run\n\nRun the test suite:\n\n```bash\nswift test\n```\n\nBuild a runnable `.app` bundle:\n\n```bash\n.\u002Fscripts\u002Fbuild_app.sh debug\n```\n\nOpen the packaged app:\n\n```bash\nopen \"build\u002FApp Monitor.app\"\n```\n\nRun the full local check used by this repo:\n\n```bash\n.\u002Fscripts\u002Fci\n```\n\nYou can also run the Swift package executable directly during development:\n\n```bash\nswift run AppMonitor\n```\n\nSome macOS app behaviors, including bundle identity, icon resources, menu bar behavior, login item behavior, and permission prompts, are best exercised through the packaged app from `scripts\u002Fbuild_app.sh`.\n\n## Packaging And Releasing\n\nApp Monitor's packaged app includes a GitHub-hosted appcast URL. Release packages include a zip, a branded drag-to-Applications DMG, SHA-256 checksums, and an `appcast.xml` file for update discovery.\n\nFor local packaging:\n\n```bash\n.\u002Fscripts\u002Fpackage_release.sh 1.2.0 3\n```\n\nFor a Homebrew beta cask, publish a versioned beta GitHub release and generate the cask file for a tap:\n\n```bash\nAPP_MONITOR_TAG=\"v1.2.0-beta.3\" .\u002Fscripts\u002Fpackage_release.sh 1.2.0 3\n.\u002Fscripts\u002Fgenerate_homebrew_beta_cask.sh 1.2.0 3\n```\n\nThe unsigned\u002Fad-hoc local package is useful for development. Public distribution should use Developer ID signing and Apple notarization so Gatekeeper can verify the app. See [RELEASING.md](RELEASING.md) for the exact commands, signing options, and local verification steps.\n\n## Privacy\n\nApp Monitor is designed to run locally. It records app inventory, usage, storage scan, cleanup, uninstall, update, and settings data in a local SQLite database under `~\u002FLibrary\u002FApplication Support\u002FApp Monitor\u002F`.\n\nIt does not include telemetry, accounts, or a hosted backend. Optional update checks may contact third-party update sources or run local update tools such as Homebrew, `mas`, Apple `softwareupdate`, or app-provided Sparkle feeds. See [PRIVACY.md](PRIVACY.md) for details.\n\n## Safety Notes\n\nApp Monitor can inspect local app-related storage and can move selected files to quarantine or Trash. Cleanup candidates are shown as a quarantine review: preview the exact path, queue only the items you approve, move them to App Monitor quarantine, and restore from History while the quarantined item remains available. Review cleanup and uninstall plans before applying them, especially for containers, preferences, Application Support data, and group containers that may contain user data.\n\nUpdate installs may require administrator authorization or third-party package manager behavior outside this project.\n\n## Project Structure\n\n- `Sources\u002FAppMonitor`: SwiftUI app, dashboard, menu bar UI, and app lifecycle wiring.\n- `Sources\u002FAppMonitorCore`: inventory, usage tracking, storage scanning, cleanup, update, uninstall, analytics, export, and SQLite logic.\n- `Tests\u002FAppMonitorCoreTests`: focused core behavior tests.\n- `scripts\u002Fbuild_app.sh`: builds and signs a local `.app` bundle.\n- `scripts\u002Fci`: runs tests and verifies app bundle creation.\n\n## License\n\nApp Monitor is released under the MIT License. See [LICENSE](LICENSE).\n","App Monitor 是一款面向 macOS 的本地优先应用监控工具，用于全面追踪应用使用情况、存储占用、更新状态、卸载影响及清理机会。核心功能包括前台应用使用统计（支持会话暂停）、多路径存储扫描（含 Application Support、缓存、容器等）、基于 SQLite 的本地数据持久化、隔离式清理预览（quarantine review）、多源更新检查（Mac App Store、Homebrew、Sparkle 等）以及可逆的卸载规划。采用 Swift + SwiftUI 构建，无云端依赖，所有数据本地处理。适用于希望精细化管理 macOS 应用生命周期、优化磁盘空间、评估闲置软件价值或执行安全清理的个人用户与技术型终端用户。","2026-07-14 02:30:05","CREATED_QUERY"]