pi-mac-tools

macOS automation tools for Pi via Accessibility APIs and screenshots

Package details

← Back
extension

Install pi-mac-tools from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-mac-tools
Package
pi-mac-tools
Version
0.1.0
Published
Apr 21, 2026
Downloads
142/mo · 4/wk
Author
tuan_son.dinh
License
MIT
Types
extension
Size
81.2 KB
Dependencies
1 dependency · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-mac-tools

Native macOS automation tools for Pi.

Tools

  • mac_check_permissions
  • mac_list_apps
  • mac_launch_app
  • mac_activate_app
  • mac_quit_app
  • mac_list_windows
  • mac_screenshot
  • mac_find
  • mac_get_tree
  • mac_click
  • mac_type
  • mac_read

Requirements

  • macOS 14+
  • Swift 5.9+
  • Accessibility permission for UI automation
  • Screen Recording permission for screenshots

Install

pi install npm:pi-mac-tools

Local development:

pi install /absolute/path/to/pi-mac-tools

Notes

  • builds bundled Swift CLI on first use, then reuses cached binary
  • use mac_check_permissions first if any tool fails with permission errors
  • use mac tools for native apps, browser tools for web pages