cscb/vibe-mouse

vibe-mouse is a Python project that turns a regular mouse, keyboard, gamepad, or several other kinds of devices into shortcuts for controlling AI coding assistants like Cursor, Windsurf, GitHub Copilot, and others. Instead of reaching for the keyboard every time you want to accept a code suggestion, open a chat panel, or trigger inline code generation, you can map those actions to buttons, such as a mouse's side buttons or a gamepad's face buttons. The program runs quietly in your system tray and automatically figures out whether you are on a Mac or on Windows or Linux, so it uses the right modifier key without you needing to edit settings by hand. It supports many kinds of input beyond a standard mouse: keyboards, gamepads (Xbox, PlayStation, Switch), Bluetooth devices, infrared remotes, generic HID devices like a Stream Deck or barcode scanner, network or IoT buttons over MQTT or WebSocket, and even voice commands through wake words. Each device type is handled by its own adapter, and all of them funnel into one unified system that matches a button press or command to the coding tool you're currently using and sends the right keyboard shortcut. You can configure everything either through a visual, browser-based tool that needs no separate backend, or by editing a JSON configuration file directly. The project ships with a one-click build script to package it into a Windows .exe or a Mac .app. Optional hardware feedback, like a sound, on-screen overlay, tray notification, LED, or vibration, can confirm when an action has fired. Beyond the mouse software itself, the repository is described as one part of a larger open-source system that also includes a robot actuator and a mobile monitoring setup, though those are separate, independently usable modules within the same repo. Because those two parts are not fully documented within the portion of the README available here, this explanation focuses on the vibe-mouse interaction tool. Setup requires installing Python dependencies, plus optional extra packages depending on which devices you want to use.