Inspiration
Every streamer knows the moment: you're stuck on a puzzle, and chat floods with the answer. Streamers end up typing "no backseating", and viewers who just wanted to help feel ignored. We wanted to turn that urge to help into something fun and consent-based.
What it does
Hint Jar is a Twitch chat bot + OBS overlay + streamer dashboard.
- Viewers type
!hint <idea>. The text goes into a jar instead of onto the stream. With an optional bot token, the!hintmessage is deleted from chat via the Twitch Helix moderation API, so the streamer never sees the spoiler. - Similar hints are clustered automatically (token normalization + Jaccard similarity, no paid AI). Each viewer counts once; a new
!hintreplaces their old one. - The overlay shows a glass jar filling with marbles (one per viewer, colored by theory) and a meter: "14 viewers think they know".
- When the streamer gives up, they choose how much help to take:
!reveal 1(nudge: number of theories, top cluster size, a masked keyword likel____),!reveal 2(direction: the top hint with half the words masked),!reveal 3(the full answer, credited to the first viewer who called it). Closing the jar shows first-caller credits. 1080p screenshot. I reviewed each round, ran it against a real Twitch channel, ## How we built it (with OpenAI Codex)ded the requiredPASSline and reformatted the code. - Overlay polish after reviewing a
I wrote the product spec in
AGENTS.md, then built the app with the OpenAI Codex CLI in one session (codex exec, thencodex exec resumefor follow-ups): - Codex generated the whole project from the spec: HTTP + SSE server, Twitch IRC WebSocket client (IRCv3 tags, badges, PING/PONG, reconnect with backoff), Helix helper, clustering/masking/reveal logic, canvas overlay, dashboard, node:test tests and README.
- Round 2: live IRC even in demo mode, a timed
/demo/scriptshowcase, and a polished overlay/dashboard. - Bug fix: anonymous Twitch IRC was closing immediately; Codex ad
Built With
- canvas
- html5
- javascript
- node.js
- openai-codex
- server-sent-events
- twitch