nodex-head-gestures

Ask yes/no questions via AirPods head gestures using the local Nodex CLI.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill nodex-head-gestures-jamsdoescode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nodex-head-gestures
Source: https://github.com/jamsdoescode/Erik-s-Portfolio/tree/main/openclicky/AppResources/OpenClicky/OpenClickyBundledSkills/nodex-head-gestures
Command: npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill nodex-head-gestures-jamsdoescode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Hands-free users running OpenClicky Agent Mode tasks need a way to answer simple confirmation prompts without typing, and this Skill provides binary yes/no input through AirPods head gestures. ## Core Features & Use Cases - Head-Gesture Confirmation: Map AirPods nod and shake motions to yes/no answers through the local nodex-motion CLI with configurable timeouts and defaults. - Keyboard Fallback: Fall back to the nodex CLI with y/n keyboard input when head-motion hardware or permissions are unavailable. - Safety Guardrails: Enforce conservative defaults, one question at a time, and typed confirmation for destructive or irreversible actions. - Use Case: During a long-running agent task, ask "Should I run the focused tests now?" and let the user nod to approve without touching the keyboard. ## Quick Start Ask the user a yes/no question using Nodex head gestures, for example whether to continue with the current patch.

Frequently Asked Questions about nodex-head-gestures

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ask yes/no questions with AirPods head gestures?

Run nodex-motion ask with your question, the --motion-only flag, a timeout, and a default answer. A nod returns exit code 0 for yes and a shake returns exit code 1 for no.

How do I check if Nodex is installed on macOS?

Run command -v nodex-motion or command -v nodex in the terminal. If neither command exists, Nodex is not installed and you should use normal typed input instead.

What happens when a Nodex head-gesture question times out?

A timeout returns exit code 2 and is treated as no for risky actions or as the conservative default for ordinary choices. You can set the fallback behavior with the --default flag.

Can I use head gestures to approve destructive actions?

No. Head gestures must not be the only approval for destructive, production, financial, email, or irreversible actions. Those cases require explicit typed confirmation from the user.

Does Nodex work without AirPods or motion permissions?

Head-motion input requires a compatible Apple headphone model and macOS Motion and Fitness permission. Without them, use the nodex ask keyboard fallback with y/n keys instead.