run-mac-app-with-logs

Launches the Moolah macOS app and streams OSLog output to a local file for debugging.

1|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/moolah-rocks/moolah-native --skill run-mac-app-with-logs-moolah-rocks
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: run-mac-app-with-logs
Source: https://github.com/moolah-rocks/moolah-native/tree/main/.claude/skills/run-mac-app-with-logs
Command: npx skills add https://github.com/moolah-rocks/moolah-native --skill run-mac-app-with-logs-moolah-rocks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Diagnosing macOS app issues like CloudKit sync failures, crashes, hangs, or unexpected behavior is hard when runtime logs are invisible. This Skill builds and launches the Moolah macOS app while capturing os_log output to a file, so you can inspect real runtime behavior and verify that newly added log statements actually emit. ## Core Features & Use Cases - Build, launch, and stream logs: Runs just run-mac-with-logs to start the app and continuously write logs to .agent-tmp/app-logs.txt, with support for custom log predicates (e.g., filtering by category like ProfileSyncEngine). - Log inspection and monitoring: Provides grep-based workflows to find errors, count occurrences, watch specific categories, and stream matching lines as they arrive. - Crash analysis: Locates crash reports in ~/Library/Logs/DiagnosticReports/ and parses .ips files to extract the faulting thread stack trace. - Use Case: A CloudKit sync bug only reproduces at runtime. Launch the app with logs captured, reproduce the issue, then grep the log file for error or Failed entries to pinpoint the failing sync operation. ## Quick Start Ask the agent to run the Moolah macOS app with logs captured and then check the log file for errors related to the problem you are investigating.

Frequently Asked Questions about run-mac-app-with-logs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a macOS app and capture os_log output?▼

Run `just run-mac-with-logs` to build, launch the app, and stream all com.moolah.app logs to `.agent-tmp/app-logs.txt`. The script exits immediately in non-interactive mode while the app and log stream keep running in the background.

How do I filter macOS log stream output by category?▼

Pass a custom predicate as a single quoted argument, for example `just run-mac-with-logs 'category == "ProfileSyncEngine"'`. The predicate must be wrapped in single quotes, and complex predicates with parentheses work inside them.

Why do my os_log values show as <private> in the log stream?▼

OSLog redacts dynamic values by default for privacy. Add `privacy: .public` to your logger calls to make interpolated values visible, otherwise standard string interpolation appears as `<private>` in captured logs.

How do I find the crash stack trace for a crashed macOS app?▼

Check `~/Library/Logs/DiagnosticReports/` for recent Moolah `.ips` files, then parse the JSON body to read the faulting thread's frames. The Skill includes a python3 snippet that prints symbols with source file and line numbers.

What should I do if the app is already running when I start log capture?▼

The script exits with an error if an instance is already running. Stop it first with `pkill -f "Moolah.app/Contents/MacOS/Moolah"` and kill any existing log stream with `pkill -f "log stream.*com.moolah.app"` before relaunching.