OpenParable
Skip to content
← Back to skills

Nodex Head Gestures

Apps & Automation
nodex-head-gestures

Nodex 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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 using nodex 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: yes
  • 1: no
  • 2: timeout
  • 64: 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

  1. Ask exactly one yes/no question at a time.
  2. Phrase questions so both yes and no have obvious meanings.
  3. Prefer conservative defaults over low-value interruptions.
  4. 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.
  5. Avoid --log when 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.