@howaboua/pi-gippity-control

GipPity voice and LAN remote control for any Pi model

Packages

Package details

extension

Install @howaboua/pi-gippity-control from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@howaboua/pi-gippity-control
Package
@howaboua/pi-gippity-control
Version
0.0.6
Published
Aug 4, 2026
Downloads
590/mo · 590/wk
Author
howaboua
License
MIT
Types
extension
Size
43.3 MB
Dependencies
4 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

GipPity Control

Voice and LAN remote control for Pi, without replacing your active model or tools.

GipPity uses an OpenAI Codex login for its realtime audio connection, then routes work into the current Pi session. The Pi session can use any model provider.

Install

pi install npm:@howaboua/pi-gippity-control

Log into openai-codex in Pi, then run /gippity.

Do not install this alongside @howaboua/pi-codex-conversion; that package already includes GipPity voice control.

Controls

Action Default
Realtime voice Ctrl+Alt+Space
Mute realtime microphone Ctrl+Alt+M
Hold to dictate Ctrl+Alt+D
LAN control server Ctrl+Alt+G

Commands:

  • /gippity — settings
  • /gippity realtime
  • /gippity mute
  • /gippity dictation
  • /gippity stop
  • /gippity server

Settings live in ~/.pi/agent/pi-gippity-control.json. Keybind changes take effect after /reload.

The LAN server includes a microphone mute button. The host retains the Realtime WebRTC call and relays 24 kHz mono audio to the active browser, so moving between devices does not restart the voice session. The server is unauthenticated by design for trusted networks, uses a local HTTPS certificate, belongs only to the Pi session that started it, and stops when that session changes.

The global realtime prompt lives at ~/.pi/agent/REALTIME-SYSTEM-PROMPT.md; trusted projects can append .pi/REALTIME-SYSTEM-PROMPT.md. GipPity ships its current template and cumulative schema changelog as raw Markdown. It checks the marker only when realtime voice is engaged and asks your agent to migrate outdated customized prompts instead of rewriting them automatically. Both paths are shown in /gippity.