gesture-confirm

gesture-confirm

Claude Code marketplace repository for the gesture-confirm plugin. The plugin uses MediaPipe hand tracking with a native macOS WKWebView host for gesture-based confirmation and selection.

macOS only. The plugin embeds a native WKWebView host and is not intended for Linux or Windows.

Quick Install

claude plugin marketplace add github:cloudgeek/gesture-confirm
claude plugin install gesture-confirm@gesture-confirm-marketplace

Features

• Confirm mode: Thumbs up = allow, Fist = deny
• Select mode: Show 1-5 fingers to choose between options
• Real-time camera feed with hand landmark visualization
• 1.5s hold to confirm (prevents accidental triggers)
• Keyboard & button fallbacks when camera is unavailable

Requirements

• macOS
• Node.js 18+
• Xcode Command Line Tools (for the native host build)

Install

This repository is a marketplace, not a single-plugin root. Add the marketplace first, then install the plugin from it.

From a local checkout:

claude plugin marketplace add /path/to/gesture-confirm
claude plugin install gesture-confirm@gesture-confirm-marketplace

From GitHub:

claude plugin marketplace add github:cloudgeek/gesture-confirm
claude plugin install gesture-confirm@gesture-confirm-marketplace

The plugin implementation lives in plugins/gesture-confirm. Dependencies are auto-installed on first hook execution via the hook script.

Usage

As a Hook (automatic)

The plugin registers a PreToolUse hook for Bash|Write|Edit tools. A gesture confirmation window appears automatically before these tools execute.

As a Skill (manual)

Ask Claude to use gesture confirmation:

"Use gesture confirm for this plan" "Let me select with gesture"

CLI (standalone)

If you have not triggered the hook before, install the script dependencies once:

cd plugins/gesture-confirm/scripts
npm install
cd ../../..

# Confirm mode
node plugins/gesture-confirm/scripts/gesture-confirm.mjs --message "Deploy to production?"

# Select mode
node plugins/gesture-confirm/scripts/gesture-confirm.mjs --mode select --options "Approach A,Approach B,Approach C"

Gestures

Gesture	Confirm Mode	Select Mode
Thumbs up	Allow	-
Fist	Deny	Cancel
1 finger	-	Option 1
2 fingers	-	Option 2
3 fingers	-	Option 3
4 fingers	-	Option 4
5 fingers (open hand)	-	Option 5

Keyboard: Enter/Esc (confirm), 1-5/Esc (select)

License

MIT