reward extension

A system tray app that plays a reward sound when your code succeeds. Works with any editor, any terminal, any build tool.

Folder Structure

├── assets/
│   └── tray-icon.png      ← 16x16 tray icon (add your own)
├── cli/
│   └── gg.js              ← CLI trigger script (`gg` command)
├── src/
│   ├── main.js            ← Electron main process
│   ├── preload.js         ← Secure bridge for settings window
│   └── settings.html      ← Settings UI
├── package.json
└── README.md

Quick Start

cd good-girl-desktop
npm install
npm start

The app runs silently in your system tray. Right-click the tray icon to open the menu.

First-time Setup

1. Right-click tray icon → Settings...
2. Click Browse... and choose your .mp3 / .wav / .ogg sound file
3. Click Save
4. Click Test Sound to verify it works

CLI Integration — The gg command

After installing dependencies, wire gg into your terminal workflow:

# Play "good girl" after a successful build
npm run build && npx gg

# Play after passing tests
npm test && npx gg

# Any command
your-command && npx gg

Install globally for the cleanest usage:

npm install -g .
# now just use:
npm run build && gg

Tray Menu

Settings

Settings are saved to your OS user data directory automatically.

Building a distributable

# Install electron-builder (once)
npm install

# Build for current platform
npm run dist

Output goes to the dist/ folder.

How It Works

• The tray app starts a local Unix socket (or Windows named pipe)
• The gg CLI connects to that socket and sends "play"
• The tray app plays the sound via a hidden Electron BrowserWindow
• If the tray app is not running, gg silently exits — your build pipeline is never broken

Good girl!