Claude Code Logitech Haptic Plugin banner
ChefJodlak ChefJodlak

Claude Code Logitech Haptic Plugin

Productivity community

Description

Claude Code hook integration that triggers MX Master 4 haptic feedback via HapticWebPlugin for permission prompts, idle states, and task completion events.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

Claude Code Haptic Feedback Plugin

![Claude Code Haptic Feedback Plugin](static/banner.png)

A lightweight integration that delivers tactile notifications through your Logitech MX Master 4 mouse when Claude Code requires your attention or completes a task.

Overview

When working with Claude Code, it's common to switch context while waiting for responses. This plugin solves the "tab-switching problem" by providing physical feedback directly through your mouse, eliminating the need to constantly monitor the terminal.

How It Works

Claude Code Event → Hook System → Shell Script → HTTP API → HapticWebPlugin → MX Master 4
  1. Claude Code emits lifecycle events through its hook system
  2. The hook triggers our shell script with event metadata
  3. The script maps the event type to an appropriate haptic waveform
  4. An HTTP request is sent to the locally-running HapticWebPlugin
  5. HapticWebPlugin communicates with Logi Options+ to activate the haptic motor

Supported Events

Event Haptic Pattern Description
Permission Request knock Claude needs authorization to execute a tool
Idle Prompt ringing Claude is waiting for user input (60+ seconds)
Task Complete completed Claude has finished responding

Prerequisites

Requirement Details
Hardware Logitech MX Master 4 mouse
Software Logi Options+ application
Plugin HapticWebPlugin (installation instructions below)
System macOS, Linux, or Windows (Git Bash/MSYS2/WSL) with bash and curl

Installation

Step 1: Install HapticWebPlugin

HapticWebPlugin is a third-party Logi Options+ plugin that exposes the MX Master 4 haptic motor through a local HTTPS API. This bridge is necessary because Logitech does not provide a public API for haptic control.

The plugin is included in this repository under the `plugin/` directory. It is sourced from [Fallstop/HapticWebPlugin](https://