Plugin for Claude Code

ClaudePad

Vibe-code from your couch.

Approve with A, deny with B, commit+push with a Hadouken.

Get Started View on GitHub

$ claude mcp add claudepad -- npx -y claudepad

✓ Added claudepad MCP server

$ claude

✓ Controller detected: Xbox Wireless Controller

[A] Approved! ✓

[B] Denied ✗

⚡ Combo: Hadouken → git commit + push

Features

Everything you need to code from the couch.

16 Mapped Buttons

Every Xbox button mapped to a Claude Code action. Approve, deny, scroll, navigate — all from your controller.

Fighting Game Combos

Hadouken to commit+push. Shoryuken to reset. Input sequences trigger real actions — with timing windows.

Haptic Feedback

8 vibration patterns. Know when Claude is done thinking, when errors occur, or when combos activate — without looking.

Voice Input

Xbox button triggers /voice transcription. Dictate prompts to Claude Code hands-free from across the room.

One-Liner Install

One command to add to Claude Code. 6 MCP tools — read state, wait for input, send rumble, detect combos, configure mappings.

Daemon Mode

Run standalone via launchd. Always-on gamepad input without MCP — just controller-to-terminal, directly.

Button Map

Every button has a purpose. Here's the full layout.

Button	Keys	Action
`A`	`y + Enter`	Approve (yes + Enter)
`B`	`n + Enter`	Deny (no + Enter)
`X`	`Ctrl+C`	Interrupt
`Y`	`Escape`	Skip
`LB`	`Ctrl+B PgUp`	Scroll up (tmux)
`RB`	`Ctrl+B PgDn`	Scroll down (tmux)
`D-pad ↑`	`Up`	Arrow up
`D-pad ↓`	`Down`	Arrow down
`D-pad ←`	`Left`	Cursor left
`D-pad →`	`Right`	Cursor right
`Menu`	`Enter`	Enter / confirm
`View`	`Ctrl+C`	Interrupt
`Xbox`	`/voice Enter`	Voice input
`L3`	`Tab`	Autocomplete
`R3`	`/ Enter`	Slash command menu

Combo System

Input sequences within a time window trigger special actions — just like fighting games.

Quick Approve

★☆☆ Novice

A→A

300ms

Approve with “proceed”

Turbo Mode

★★☆ Advanced

LB→RB

200ms

Toggle auto-approve

Hadouken

★★★ Master

↓→→→A

500ms

git commit + push

Shoryuken

★★★ Master

→→↓→→→B

600ms

Reset conversation

EASTER EGG

Konami Code

★★★ Master

↑↑↓↓←→←→BA

3000ms

Rainbow rumble

Haptic Patterns

Your controller vibrates to communicate state — no need to look at the screen.

success

Gentle double pulse — task completed

error

Hard long buzz — something broke

warning

Medium single pulse — heads up

approval_prompt

Triple tap rhythm — Claude needs your input

task_complete

Rising crescendo — major milestone

combo_activated

Sharp snap — combo detected

voice_start

Light click — voice recording started

rainbow

Wave crescendo — easter egg activated

Quick Start

One command. That's it.

Install SDL2 (one-time)

brew install cmake sdl2

Add to Claude Code

claude mcp add claudepad -- npx -y claudepad

Restart Claude Code, connect your Xbox controller via Bluetooth, and you're done.

Architecture

How your button presses reach Claude Code.

Plugin mode: One command to install. Claude Code connects via MCP and calls gamepad tools directly.
Daemon mode: Runs standalone via launchd — button presses inject keystrokes into the active tmux session.