Nodex Head Gestures
Apps & Automationnodex-head-gesturesNodex Head Gestures is an Agent Skill for apps & automation published in the jasonkneen/openclicky repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Ask low-risk yes/no questions through the optional local Nodex AirPods head-gesture helper. Use when the user wants to answer by nodding or shaking their head, says they are hands-free, or asks for AirPods gesture confirmation while an OpenClicky Agent Mode task is running.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/jasonkneen/openclicky/blob/HEAD/AppResources/OpenClicky/OpenClickyBundledSkills/nodex-head-gestures/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/nodex-head-gestures, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Nodex Head Gestures
Use the optional local Nodex CLI to ask one binary question at a time when the user wants hands-free yes/no control.
Nodex maps:
- nod = yes
- shake = no
- keyboard
y/n= fallback when usingnodex ask
Preconditions
Check for Nodex before using it:
command -v nodex-motion || command -v nodex
If neither command exists, tell the user Nodex is not installed and use normal OpenClicky input instead. Do not try to install software unless the user explicitly asks.
AirPods/head-motion input requires a compatible Apple headphone model, macOS Motion & Fitness permission, and the nodex-motion app wrapper.
Ask With Head Gestures
For AirPods head gestures, prefer:
nodex-motion ask "Should I continue with this patch?" --motion-only --timeout 25 --default no
Interpret exit codes:
0: yes1: no2: timeout64: setup or usage error
Treat timeout as no for risky actions and as the conservative default for ordinary choices.
Ask With Keyboard Fallback
If head gestures are unavailable but Nodex is installed:
nodex ask "Should I run the focused tests?" --log --default no
Use --voice kokoro only if the user asked for Kokoro or the local Nodex setup is known to support it.
Rules
- Ask exactly one yes/no question at a time.
- Phrase questions so both yes and no have obvious meanings.
- Prefer conservative defaults over low-value interruptions.
- Do not use head gestures as the only approval for destructive, live production, customer-facing, financial, email, remote-server, secret-bearing, or irreversible actions. Require typed confirmation for those.
- Avoid
--logwhen the question contains secrets or sensitive personal data.
Good Questions
- "Should I run the focused tests now?"
- "Should I keep the current UI layout?"
- "Should I skip the optional refactor?"
Bad Questions
- "What should I do next?"
- "Which option do you prefer?"
- "Should I do the risky thing?" without naming the concrete risk.