gempper
v1.0.1
Published
One-command setup for Gempper — a Flipper Zero remote for Gemini CLI
Downloads
209
Maintainers
Readme
Gempper
A Flipper Zero remote control for Gemini CLI. One-handed coding with 5 buttons: approve (1/2/3), enter, and voice dictation.
Install
npx gempperThis installs:
- Gemini CLI skill — makes Gemini present every decision as 3 numbered choices (installed to
~/.gemini/skills/gempper/) - Flipper Zero apps — BLE and USB
.fapfiles ready to copy to your Flipper - Macro presets — pre-built command sets (default, debugging, workflow, etc.)
Usage
- Open Gemini CLI
- Gemini CLI auto-activates the skill (no manual command needed)
- Pick up your Flipper and start coding
Every Gemini response becomes:
1. [What you most likely want]
2. [Show details first]
3. [Change direction]Flipper Setup
After running npx gempper, copy the right .fap to your Flipper's SD card:
| Firmware | File | SD Path |
|----------|------|---------|
| Momentum / Unleashed | ~/gempper/gemini_remote_ble.fap | apps/Bluetooth/ |
| Stock | ~/gempper/gemini_remote_usb.fap | apps/Tools/ |
Macros (optional)
Copy a macro preset to your Flipper:
~/gempper/macros/default.txt -> SD/apps_data/gemini_remote_ble/macros.txtAvailable presets: default, minimal, barebones, debugging, workflow, review, maximalist
Uninstall
npx gempper --uninstallLinks
Adapted from Claupper by Kasen Sansonetti & Wetware Labs.
