Aqua Quest

Pixel-art hydration companion for VS Code. A tiny droplet named Dew lives in an Aqua Boy handheld in your sidebar. Drink water, fill the well, keep the combo alive.

Built as a VS Code extension: TypeScript, Command Palette commands, and an Extension Development Host you launch with F5.

Run it

1. npm install
2. Open this folder in VS Code / Cursor
3. Press F5 (or Debug: Start Debugging)
4. In the Extension Development Host window, open the Aqua Quest icon in the activity bar
5. Click Water 0/8 · 29:59 in the bottom status bar (left side) for Drink / Selfie
6. Run Aqua Quest: Drink +1 from the Command Palette, or press Cmd+Alt+W / Ctrl+Alt+W

Aqua Quest: Open Aqua Boy pops the full handheld into an editor panel. Aqua Quest: Pixel Selfie opens the camera booth.

What it does

• Status bar on the left: Water 3/8 · 24:12 — live countdown, nags every 30 minutes
• Click the status bar for Drink, pixel selfie, Aqua Boy, or snooze
• Sidebar HUD + Game Boy–style panel with a pixel well and Dew’s mood
• Pixel selfie: webcam → 8-bit mosaic + water bottle overlay. Only the pixelated PNG is saved (never the raw photo)
• Gallery of saved shots inside Aqua Boy
• Daily goal, streak combo, undo, 8-bit blips, quiet hours
• Local history: every day, every drink timestamp, streaks, and pixel selfies are saved on disk

Local data

Everything lives in Cursor/VS Code user storage (not the git repo):

• aqua-data.json — today + full day history (glasses, ml, goal, drink times, selfie filenames, streaks)
• gallery/dew-*.png — pixelated selfies only

Command Aqua Quest: Open Local Data Folder (also in the status bar menu) reveals that folder in Finder. On Mac with Cursor it is typically:

~/Library/Application Support/Cursor/User/globalStorage/jyotiradityasingh.aqua-quest/

The F5 debug window uses a separate folder from your normal Cursor window.

Commands

Preview the pixel UI in a browser: npm run preview then open http://localhost:4173/preview.html.