AI Agent Hub
Back to plugins
🖥️

dsh-gesture-mouse

Client Updated 2026.08.16

Run the following command in DeepSeek Harness:

dsh plugin install zfu691531-hash/dsh-gesture-mouse

Paste the following prompt into your AI chat to install this plugin:

Run dsh plugin install zfu691531-hash/dsh-gesture-mouse in DeepSeek Harness to install the dsh-gesture-mouse plugin (source: https://github.com/zfu691531-hash/dsh-gesture-mouse).

About this plugin

Wrist fatigue from hours of mouse use is real. dsh-gesture-mouse turns the macOS built-in camera into a touchless gesture input: point your index finger to move the cursor, pinch thumb and index to click or press-drag, swipe index and middle finger to scroll, and open your palm wide to freeze everything and trigger a local panic stop. The entire real-time pipeline—vision recognition, filtering, state machine, CoreGraphics mouse event synthesis—runs on the Mac itself. No LLM is involved. IPC carries only gestureId, confidence, and timestamps; frames and joint points never leave memory, are never uploaded, and are never saved. Low latency, zero privacy leakage, no cloud inference dependency.

The plugin deliberately separates "does it work" from "is it polished." The V0 baseline ships a full DSH toolset (gesture_status / start / stop / test_trigger), mandatory cooldowns and deduplication, per-minute rate caps, authenticated IPC lifecycle management, and a set of auditable safety floors that no config file can weaken. All special gestures are disabled by default and must be individually opted into. Vision confidence still degrades under low light, occlusion, or unusual hand shapes, so it is best treated as a supplementary channel alongside your primary mouse rather than a sole input device.

If you already run the DeepSeek Harness CLI, are curious about camera-based gesture interaction, and want the whole process to be auditable, reversible, and free of screen-recording permissions, this is a community project worth trying and helping to calibrate. It is aimed at macOS 13+ users who enjoy the "reach and operate" experience and are willing to spend a few minutes tuning sensitivity and minimumConfidence on their own hardware.

Use Cases

  • Easing wrist strain during long mouse-heavy sessions by swapping repetitive clicks for pinch and point gestures
  • Steering the cursor and scrolling during a remote call or live demo without touching the mouse
  • Prototyping on-device camera-driven HCI where every frame stays in memory and no cloud round-trip is needed

Best For

  • macOS developers already on the DeepSeek Harness CLI who want to grow their local toolchain
  • Gesture-interaction enthusiasts willing to calibrate sensitivity and confidence thresholds on real hardware
  • Input-device tinkerers who refuse screen-recording permissions and demand that every frame stays in memory