Skip to content

Desktop app

Hooksmith for Mac.

Forward live webhooks to your local server, edit hooks with the agent, and get a menu bar alert when a delivery fails.

Version 0.1.2 · macOS 13 Ventura or later. Not sure which one you have? Apple menu, About This Mac.

Signed and notarized by Apple.

Sample Tunnel window: a hook forwarding to localhost with a live log of deliveries.

What it does

Four things, one menu bar app

Tunnel to localhost
Replay live events to your local server with the original body bytes and the provider's signature headers, so the signature still verifies, like stripe listen. Or send the transformed payload a destination would get.
Menu bar and failure alerts
A tray popover shows recent events across hooks and the tunnel state. A native notification fires when a delivery fails, at most once per hook every five minutes, and clicking it opens the event.
Editor with the agent
Open a hook from a local .hooksmith folder or pull a deployed one. Ask the agent for a change, review a side-by-side diff, test offline against sample payloads, then deploy.
Dashboard window
The full Hooksmith dashboard in its own window: filter events, inspect every attempt, replay, and send test events. External links open in your browser.

What the tunnel can and cannot do

Stated plainly, so you know what to expect before you point a sender at your laptop.

  • Polling, not push. The tunnel asks for new events every few seconds and backs off when idle. It stops when paused or when no tunnel is active.
  • Resending an old event fails provider checks. Stripe and Standard Webhooks reject signatures older than about 5 minutes, so resend fresh events only.
  • Hooks that do not keep their payload cannot be tunneled, because there is no stored request to replay.
  • Only localhost, 127.0.0.1, [::1] and *.localhost targets are allowed. The app refuses anything else in the main process.

Privacy

  • Your personal access token is stored encrypted with Electron safeStorage, backed by the macOS Keychain. The renderer never sees it.
  • The tunnel forwards only to localhost. The rest of the app talks to the Hooksmith API and dashboard.
  • Settings are a plain file in your user folder and contain no secrets.

Updates

The app checks for a new version about 30 seconds after it starts and every six hours. It never downloads an update without your click. The dashboard window is the same web app as hooksmith.tech/app, and it signs in with its own web session.

Prefer the CLI? It works without the desktop app, see the install guide.

Get the app, then sign in

Sign in opens your browser once to approve a short code. Read the desktop docs for the details.