automate-app

Automates the running Moolah macOS app via AppleScript for data operations and navigation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Verifying UI changes and inspecting app state in the Moolah macOS app normally requires manual clicking through the interface. This Skill lets you drive the running app from the terminal via AppleScript, so you can create test data, read balances, navigate views, and capture screenshots programmatically. ## Core Features & Use Cases - AppleScript automation wrapper: The moolah-tell script targets the worktree's debug build instead of the installed release app, with a duplicate-instance check that prevents two Moolah instances from sharing one CloudKit container. - Full data operations: Create, read, and delete profiles, accounts, transactions, earmarks, and categories; query balances, positions, and net worth; filter transactions and legs server-side. - Navigation, sync, and screenshots: Open profile windows, switch sidebar views, force synced-account re-imports, and capture sandboxed screenshots without Screen Recording permission. - Use Case: After changing transaction logic, run a script that creates a test transaction, reads back the account balance, and captures a screenshot of the account detail pane to verify the change end-to-end. ## Quick Start Build and launch the app with just run-mac, then ask the AI to list every profile and account balance in the running Moolah app using the automate-app skill.

Frequently Asked Questions about automate-app

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

FAQPage Schema
How do I automate a macOS app with AppleScript from the terminal?▼

Use osascript with a tell application block targeting the app's absolute bundle path. The moolah-tell wrapper handles this for Moolah, auto-wrapping your script body and resolving the correct debug build in the worktree.

How do I create test transactions in the Moolah app?▼

Run moolah-tell with a create txn command specifying payee, amount, account, and optionally category, date, and notes. Expenses use negative amounts and income uses positive amounts, and you should read back the balance to verify.

Why does osascript target the wrong Moolah app instance?▼

Raw osascript resolves the app name through LaunchServices, which picks the installed release build in /Applications over the worktree debug build. The moolah-tell wrapper targets the absolute bundle path and refuses to launch a duplicate instance.

Can I take a screenshot of a macOS app without Screen Recording permission?▼

Yes, Moolah's capture screenshot AppleScript command renders the window's contentView in-process via AppKit, so no TCC permission dialog is needed. The PNG is written to the app's sandbox temp directory at native display scale.

Is it safe to automate a production profile in Moolah?▼

Development CloudKit environment profiles are safe test data and can be automated freely. Production profiles require explicit in-the-moment permission for the exact profile and operation, and unknown environments are treated as Production.