nodcode

Nod Code for Claude Code

Hands-free yes/no interactions for Claude Code using AirPods head gestures

Nod Code is a Claude Code plugin that enables gesture-based permission requests. When Claude asks for permission to run commands, edit files, or perform tasks, you can simply nod (yes) or shake (no) your head instead of clicking buttons.

Perfect for:

• Hands-free coding sessions
• When your hands are on the keyboard and you don't want to reach for the mouse
• Accessibility scenarios
• Looking cool while pair programming 😎

Demo

When Claude Code asks for permission, nodcode:

1. ✅ Checks if your AirPods are connected
2. 🔊 Speaks the permission request using your Mac's voice
3. 👂 Listens for your head gesture (15 seconds)
4. ✓ Approves on nod, denies on shake
5. 🔄 Falls back to normal UI if no gesture detected

Quick Start

Terminal setup (copy and paste):

brew install hyusap/tap/bobble
claude plugin marketplace add hyusap/cc
claude plugin install nodcode
claude

In Claude Code chat:

/plugin marketplace add hyusap/cc
/plugin install nodcode@hyusap
/nodcode:setup

Put on your AirPods and you're ready! Nod for yes, shake for no.

Requirements

• macOS: 14.0 or later
• Claude Code: 1.0.33 or later
• bobble: The head gesture detection CLI (install instructions)
• AirPods: AirPods Pro, AirPods Max, or Beats Fit Pro

Installation

Step 1: Add the marketplace

Add Ayush's plugin marketplace to Claude Code:

/plugin marketplace add hyusap/cc

Step 2: Install nodcode plugin

Option A: From the marketplace (recommended)

/plugin install nodcode@hyusap

Option B: Local installation (for development/testing)

Clone this repository and load it with --plugin-dir:

git clone https://github.com/hyusap/nodcode.git
claude --plugin-dir ./nodcode

Step 3: Run setup

Once the plugin is loaded, run the setup command in Claude Code:

/nodcode:setup

This interactive setup will:

• Check if bobble is installed (and offer to install it via Homebrew if not)
• Verify your AirPods are connected and available
• Test gesture detection
• Confirm everything is working

Manual bobble installation (if you prefer):

brew install hyusap/tap/bobble

Usage

Once installed, nodcode automatically handles permission requests:

1. Put on your AirPods (Pro, Max, or Beats Fit Pro)
2. Start Claude Code with the plugin enabled
3. When Claude asks for permission:
   • You'll hear the request spoken aloud
   • Nod your head to approve (✓)
   • Shake your head to deny (✗)
   • Do nothing for 15 seconds to see the normal permission UI

Slash Commands

• /nodcode:setup - Interactive setup to install bobble and verify AirPods configuration

How It Works

nodcode is a Claude Code PermissionRequest hook that integrates with bobble:

1. Hook triggers when Claude needs permission for a tool (Bash, Write, Edit, Task, etc.)
2. Availability check - Uses bobble --check to verify AirPods are connected (8ms)
3. Voice prompt - Speaks the request using macOS say command
4. Gesture detection - Runs bobble --timeout 15 --sensitivity 0.5
5. Response - Returns JSON decision to Claude Code based on gesture

Gesture Thresholds

The default sensitivity (0.5) uses these thresholds:

• Nod: ~6° to ~19° pitch movement
• Shake: ~13° to ~33° yaw movement

Configuration

Customizing sensitivity

To adjust gesture sensitivity, modify the --sensitivity flag in hooks/permission-with-gesture.sh:

"$BOBBLE" --timeout 15 --sensitivity 0.5  # Default
# Lower = more sensitive (0.1-0.4)
# Higher = less sensitive (0.6-1.0)

Customizing timeout

Change the --timeout value (in seconds):

"$BOBBLE" --timeout 15  # Default: 15 seconds

Troubleshooting

"bobble not found"

Install bobble:

brew install hyusap/tap/bobble

"Headphone motion not available"

• Ensure your AirPods Pro/Max or Beats Fit Pro are connected
• Make sure you're wearing them (motion detection only works when worn)
• Try disconnecting and reconnecting your AirPods

"No gesture detected within 15 seconds"

• Make more pronounced head movements
• Try lowering the sensitivity in the hook configuration
• Ensure your AirPods fit snugly

Permission UI still shows up

This is expected behavior! If:

• AirPods aren't available
• No gesture is detected within 15 seconds
• bobble encounters an error

nodcode gracefully falls back to the normal Claude Code permission UI.

Development

Project Structure