Feel and control Claude Code on Flipper Zero
I turned my Flipper Zero into a physical companion for Claude Code — it shows you what the AI is doing and lets you control it with buttons.
When vibe coding with Claude Code, it regularly needs your attention: permission prompts, task completions, errors. If you step away or switch windows, you miss them.
I built Claude Buddy — a Flipper Zero app that turns your Flipper into a physical companion for Claude Code. The Flipper stays in sync with the AI session — it shows what Claude is currently doing, plays distinct sounds, vibration patterns, and LED colors for different events, and lets you respond without going back to the terminal.
You can vibe code without ever touching the keyboard. Claude Buddy supports two ways of voice input: tap Up to toggle macOS Dictation for quick text entry, or hold Up to speak directly to the AI with Claude Code's built-in voice mode.
---
The Flipper screen mirrors Claude's state in real time:
Claude Code is connected over USB, idle and waiting for input.
Claude is reading a file — the screen updates live as tools are invoked.
---
Permission requests show up on the Flipper.
Claude Code asks for approval before running commands or editing files. Instead of switching back to the terminal, you can approve or deny right from the Flipper:
---
Slash commands are browsable on the Flipper too:
---
Full button controls:
| Button | Action |
|---|---|
| UP | Start / stop voice dictation |
| UP (hold) | Hold Space to talk in voice mode |
| LEFT | Send Esc |
| LEFT (hold) | Send Ctrl+C |
| RIGHT | Open slash command menu |
| OK | Submit Enter (⏎) |
| OK (hold) | Type "yes" and submit |
| DOWN | Send Down arrow (↓) |
| DOWN (hold) | Toggle mute |
| BACK | Send Backspace (⌫) |
| BACK (hold) | Exit |
Every event has its own sound + vibration pattern — task complete, error, permission request, notification — so you can tell what happened without looking. You can mute with Down hold.
---
Setup:
Two components — a Flipper app (fap) and a Claude Code plugin. The plugin starts and stops automatically with each Claude Code session.
Connects over USB (plug-and-play) or Bluetooth LE — auto-detects whichever is available.
Installation steps on GitHub: https://github.com/jxw1102/flipper-claude-buddy#setup
macOS only for now.
Porting to Linux or Windows should be straightforward — contributions welcome.