How gitfrog1111/openwhip works
OpenWhip is an Electron tray utility for interrupting and prompting Claude Code with keyboard automation. The user clicks the tray icon to show or drop a full-screen whip overlay, then clicks the whip to send Ctrl-C and an encouraging prompt to the previously active app. The launcher starts Electron; the main process owns tray, overlay, IPC handling, and platform-specific input. The README documents the user workflow; overlay internals were not sampled, so its click-to-IPC wiring is not asserted.
Main entry points: main.js Electron main · openwhip.js CLI launcher · preload.js IPC bridge · overlay.html Whip overlay
Components 11
App launch
- CLI launcher
bin/openwhip.js
Tray and overlay
- Electron main
main.js - Tray controls
main.js - Whip overlay
overlay.html - IPC bridge
preload.js
Keyboard automation
- Macro dispatch
main.js - Windows input
main.js - macOS input
main.js - Linux input
main.js
Other components
- User
- Active app
Connections 14
- User → CLI launcher: runs command
README.md - CLI launcher → Electron main: starts Electron
bin/openwhip.js - User → Tray controls: clicks icon
main.js - Electron main → Whip overlay: loads window
main.js - Electron main → IPC bridge: configures preload
main.js - Electron main → Whip overlay: sends spawn/drop
main.js - IPC bridge → Electron main: sends IPC
preload.js - Electron main → Macro dispatch: handles crack event
main.js - Macro dispatch → Windows input: dispatches on Windows
main.js - Macro dispatch → macOS input: dispatches on macOS
main.js - Macro dispatch → Linux input: dispatches on Linux
main.js - Windows input → Active app: types keystrokes
main.js - macOS input → Active app: types keystrokes
main.js - Linux input → Active app: types keystrokes
main.js