Support
Contact
Email support@studio-suama.com with questions or bug reports. When reporting an issue, please include your Mac model, macOS version, Hirari version, and steps to reproduce.
System requirements
- macOS 13 Ventura or later
- Apple silicon Mac (M1 or later; Intel Macs are not supported)
- Built-in MacBook trackpad or Apple Magic Trackpad
Troubleshooting
Gestures are not responding
Run the bundled diagnostic command hirari doctor in Terminal to check daemon status, Accessibility permission, config syntax, trackpad detection, and conflicts with macOS gestures:
/Applications/Hirari.app/Contents/Helpers/hirari doctor
Installing the AI agent skill (Claude Code, etc.)
Run the following command once to install the bundled SKILL.md into ~/.claude/skills/hirari/SKILL.md:
/Applications/Hirari.app/Contents/Helpers/hirari skill install
A gesture conflicts with macOS
System Settings > Trackpad includes built-in three- and four-finger gestures. If the same gesture is enabled in both macOS and Hirari, both will trigger. Disable one of them. Hirari highlights conflicting bindings in its settings window.
Hirari does not start after a reboot
Enable "Open at Login" in the General tab of Hirari's settings. If it was disabled under System Settings > General > Login Items, re-enable it there.
Updating
Choose "Check for Updates…" from the Hirari menu bar icon.
Uninstalling
- Quit Hirari from the menu bar
- Move
Hirari.appfrom Applications to the Trash - To remove your configuration file as well, delete
~/.config/hirari
Exporting diagnostic logs
To attach logs to a bug report, run this command in Terminal to save the last hour of Hirari logs to your desktop:
/usr/bin/log show --last 1h --predicate 'subsystem == "com.studio-suama.hirari"' > ~/Desktop/hirari-log.txt
Company
Studio Suama LLC, studio-suama.com