Gesture Confirm

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.