Hirari

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

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

  1. Quit Hirari from the menu bar
  2. Move Hirari.app from Applications to the Trash
  3. 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