gesture-confirm

Gesture Confirm — Hand Gesture Confirmation & Selection via Native WKWebView + MediaPipe

Open a native macOS window with a live camera feed and MediaPipe hand tracking. Two modes: confirm (allow/deny) and select (choose from 1-5 options by finger count).

Modes

Confirm Mode (default)

• OK gesture 👌 (thumb + index touching, hold 1.5s) → Allow
• Fist ✊ (hold 1.5s) → Deny
• Keyboard: Enter = allow, Escape = deny

Select Mode

• 1 finger (index) → Option 1
• 2 fingers (index + middle) → Option 2
• 3 fingers (thumb + index + middle) → Option 3
• 4 fingers (index + middle + ring + pinky, no thumb) → Option 4
• 5 fingers (all fingers open) → Option 5
• Fist ✊ → Cancel
• Keyboard: 1-5 = select, Escape = cancel

Prerequisites

The plugin ships a local Swift WKWebView host in scripts/native/. Running npm install in the scripts directory compiles that host binary.

Execution Steps

Step 1 — Ensure dependencies are installed

SCRIPTS_DIR="${CLAUDE_PLUGIN_ROOT}/scripts"
if [ ! -x "$SCRIPTS_DIR/node_modules/@cloudgeek/glimpse/glimpse" ]; then
  cd "$SCRIPTS_DIR" && npm install
fi

Step 2 — Run gesture confirmation

Confirm mode:

node "${CLAUDE_PLUGIN_ROOT}/scripts/gesture-confirm.mjs" --message "Approve this plan?"

Select mode:

node "${CLAUDE_PLUGIN_ROOT}/scripts/gesture-confirm.mjs" --mode select --options "Option A,Option B,Option C" --message "Choose an approach:"

Optional: --timeout 30000 (milliseconds, default 30s).

Step 3 — Parse the result

Confirm mode outputs:

{"permissionDecision": "allow"}

or

{"permissionDecision": "deny"}

Select mode outputs:

{"selection": 2, "label": "Option B"}

or on cancel:

{"selection": 0, "label": ""}

Troubleshooting

• Camera not available: Fallback buttons and keyboard shortcuts are always available.
• MediaPipe loading slow: First run downloads model files (~5MB) from CDN. Cached after.
• Native host not built: Run cd "${CLAUDE_PLUGIN_ROOT}/scripts" && npm install.