A macOS-native scripting engine with 230+ built-in functions for automation, window management, mouse/keyboard control, file I/O, and more.
brew tap AdrianSimionov/macau
brew trust AdrianSimionov/macau
brew install macaumkdir -p ~/.local/bin
curl -L "https://github.com/AdrianSimionov/macau/releases/latest/download/macau-$(uname -m)" \
-o ~/.local/bin/macau && chmod +x ~/.local/bin/macauAdd ~/.local/bin to your shell PATH if needed.
git clone https://github.com/AdrianSimionov/macau.git
cd macau
make
./macau script.mcs./macau script.mcs- 230+ built-in functions
- User-defined functions with recursion
- Full control flow (If/Select/Switch/For/While/Do)
- Maps (dictionary type with dot notation)
- Binary data with bitwise operations
- Window automation via Accessibility API
- Mouse/keyboard via CoreGraphics
- Pixel operations via ScreenCaptureKit
- File I/O, process management, INI files
- Dialogs (MsgBox, InputBox, file pickers)
- macOS 15.2+ (Sequoia or later)
- Xcode Command Line Tools (only for building from source)
| Permission | Required For | How to Grant |
|---|---|---|
| Accessibility | Window automation, Mouse/Keyboard simulation, HotKeySet | System Settings → Privacy & Security → Accessibility |
| Screen Recording | PixelGetColor, PixelSearch, PixelChecksum | System Settings → Privacy & Security → Screen Recording |
| Full Disk Access | File I/O in ~/Library/, /Library/, /System/, other users' homes |
System Settings → Privacy & Security → Full Disk Access |
| None | Everything else (200+ functions) | No special permissions |
Grant permissions to your terminal app (iTerm2, Terminal.app, etc.), not the macau binary. macOS grants permissions to the host application.
MIT