Desktop app
Tunnel live webhooks to a local server, edit hooks with the agent and get a notification when a delivery fails, all from the macOS menu bar.
Docs pagesDesktop app
On this pageDesktop app
Desktop app
Hooksmith for Mac is a menu bar app that tunnels live webhooks to a local server, edits hooks with the agent, and alerts you when a delivery fails. It runs on macOS 13 Ventura or later. Download it from the download page, choosing Apple Silicon or Intel.
Install
Open the DMG and drag Hooksmith into Applications. Launch it from Applications. The app lives in the menu bar and the dashboard opens from there.
Sign in
Choose Sign in. The app opens hooksmith.tech/device in your browser with a short code. Check that the code matches the app, then approve. The same approval flow as the CLI issues a personal token, which is stored encrypted with Electron safeStorage, backed by the macOS Keychain. The dashboard window signs in separately with its own web session.
Tunnel webhooks to localhost
Open Tunnel, pick a hook, and enter the local URL, for example http://localhost:3000/webhooks. Start the tunnel. New events for that hook are replayed to the URL and each one appears in a live log with its status, latency and response body. Pause and resume from the same screen, and resend a single event from its row.
Raw mode is the default. It sends the stored request with the exact body bytes and the provider's headers, so your local app can verify the signature the same way it would with stripe listen. Transformed mode sends what Hooksmith would deliver to a destination, with the rendered body and headers.
Editor
Open a hook from a local .hooksmith/ folder, or pull a deployed hook from the API. Edit the YAML, or ask the agent for a change. The agent's proposal opens as a side-by-side diff, where you approve or discard it. Test the hook offline against sample payloads, then deploy it.
Menu bar and alerts
The tray popover lists recent events across your hooks and shows the tunnel state. When a delivery ends as failed, you get a native notification, at most one per hook every five minutes. Click it to open the event in the dashboard window.
Updating
The app checks for a new version about 30 seconds after launch and every six hours. It never downloads an update without your click. You can also install the latest DMG from the download page at any time.
Uninstall
Quit Hooksmith, then drag it from Applications to the Trash. To remove its local data as well, delete ~/Library/Application Support/Hooksmith.
rm -rf "$HOME/Library/Application Support/Hooksmith"