@dmille56/openvibes
v0.1.9
Published
OpenVibes Pi extension for milli-powered terminal overlays.
Maintainers
Readme
OpenVibes

Overview
Sick of all those boring coding agents that kill your vibe with their 'words', 'security', 'reviews', etc? OpenVibes has a solution for you! Enabled by Pi.
Features
- Real life genie to grant your coding wishes. Never have to rely on those pesky developers again!
- Saves time by masking AI output. Now you don't have to even pretend like you were going to read it!
- Displays an animation while running to keep you engaged and prevent you from spending your attention on more important things.
- Magic wand trail output when typing. To help you really feel the vibes.
- Ambient sounds and sound effects galore! To ensure you never get too comfortable during your...uh ... break.
- Shiny colors and rainbows, carefully engineered to offend at least one design reviewer.
- No security. Major productivity improvements by skipping that stupid shit.
- Zero tests. Yes, this is intentional. No, we don't care.
Demo

Install
Prerequisite: Pi must already be installed.
Install from npm with Pi:
pi install npm:@dmille56/openvibesOr install from git:
pi install git:github.com/dmille56/OpenVibesOr install from a local checkout:
pi install /path/to/OpenVibesAfter install, start a Pi session (via pi command in a terminal) and use /openvibes to confirm the extension is loaded.
Usage
- Start a Pi session with
pi. - Run
/openvibes statusto check if the extension is still pretending to work for you. - Use
/openvibes onto control the overlay and editor effects. (Don't worry about if there's an off command or not you don't need one of those). - Pick an animation with
/openvibes select <name>if you want something other than the default. - Use
/openvibes listanytime you add or change animations so discovery gets refreshed.
Commands
/openvibesshows current status and help./openvibes onenables the overlay and editor effects./openvibes offdisables the overlay and editor effects. (Warning we may not be friends anymore if you do this)/openvibes toggleswitches between enabled and disabled./openvibes mask [status|on|off|toggle]hides the evidence. I mean, controls assistant masking./openvibes sound [status|on|off|toggle]controls cue playback./openvibes ambient [status|on|off|toggle]controls ambient loops./openvibes volume <0-1>adjusts playback volume. (0 = regret, 1 = no regrets.)/openvibes listrefreshes animation discovery and lists available animations./openvibes select <name>refreshes discovery and selects an animation by name.
Examples:
/openvibes status
/openvibes list
/openvibes select magicBundled Animations
The repo ships these bundled animations in images/:
ai_geniemagicrain
Config
OpenVibes settings are stored at:
${PI_CODING_AGENT_DIR:-~/.pi/agent}/openvibes/state.jsonUser-provided .milli files go in:
${PI_CODING_AGENT_DIR:-~/.pi/agent}/openvibes/animations/Notes:
- Default settings are
enabled: trueandselectedAnimation: "ai_genie". - Default masking is enabled.
- Default audio settings are
soundEnabled: true,ambientEnabled: true, andvolume: 1.0. - User animations are discovered recursively.
- User animations override bundled animations with the same name.
- Only
.millifiles are discovered.
Notes
When enabled, assistant messages are replaced with a generated 0/1 mask in the visible session output, and the original assistant content is restored before the next model call.
While OpenVibes is enabled, the prompt editor shows a wand trail as you type. Printable keystrokes also trigger short-lived spark bursts, and the editor frame plus status line pulse by state: idle, typing, and agent-running. The selected animation name is shown in the editor footer.
OpenVibes also plays a restrained sound layer: a wake chime on session start, an ambient loop during agent runs, short tool ticks and success pings, and small cues for /openvibes on|off|toggle plus permission approvals/denials.
If pi-permission-system opens an approval dialog, the overlay steps out of the way until the request resolves.
Troubleshooting
- If the overlay does not appear, confirm the extension is enabled with
/openvibes onand that the session has UI available. - If an animation is missing, make sure the file ends in
.milliand restart discovery with/openvibes list. - If a user animation does not override a bundled one, verify the names match exactly.
- If you're questioning your life choices that led you to install this, that's not normal don't do that shit.
