Agent Brainrot — Project Story 🤔 Inspiration

Modern browsing is a minefield of distraction. We saw two truths: people crave quick dopamine hits (“brainrot” culture—memes, shorts, micro-games), and folks with ADHD often benefit from short, predictable, low-friction breaks that reset attention without derailing the day. Agent Brainrot blends both: a bottom-right companion that serves tiny, in-place micro-breaks so you can recharge and jump back into flow—no tab switching, no rabbit holes.

Not a medical device—just a helper for focus routines and quick resets.

🧠 What We Built

A Chrome extension that injects an always-there agent bubble on any page.

Hover → category menu (Video, Jokes, Games, Fidget).

Click → opens a draggable overlay designed for 30–90s breaks, then closes.

AI micro-feed concept: rotate content types to avoid fatigue.

ADHD-friendly defaults: short loops, time caps, in-place playback, optional quiet mode.

🧩 How We Built It

Architecture

Manifest V3: background service worker, content script.

Overlay system: runs modules inside extension iframes to bypass site CSP.

Modules

Jokes: Gemini API (with simple local fallback for demos).

Video: YouTube embed in a 9:16 overlay (MVP: paste link; roadmap: AI feed).

Games/Fidget: tiny HTML/JS toys (Tic-Tac-Toe, bubble-pop).

State: chrome.storage.local for preferences, API keys, and toggles.

Personality: lightweight GIF states (idle/hover/talk/excited) to make the agent feel alive.

Flow

Toggle Agent → content script injects the agent iframe.

User picks a category → content script opens a draggable overlay.

The feature iframe fetches or generates content and encourages a short, bounded break.

Close/ESC returns focus to the page instantly.

🔧 Multi-Utility by Design

Agent Brainrot is a platform, not a toy:

Pluggable categories (video, joke, game, fidget, timers, quotes, breathing).

Persona packs: swap visuals/voice/moods without code changes.

Policy knobs: time caps, cooldowns, “focus-block → reward” loops, auto-hide in certain apps.

📚 What We Learned

ADHD support is about friction: make breaks predictable, brief, and local.

Modality rotation (audio → visual → tactile) helps prevent boredom and overuse.

CSP quirks are real; extension iframes are reliable across sites.

Resilience matters: graceful fallbacks (local content) keep demos and offline use smooth.

Small visuals, big feel: tiny GIF states go a long way without heavy assets.

🧗 Challenges We Faced

Time-boxing UX: balancing “fun enough” with “won’t spiral.”

Autoplay policies: ensuring media starts with minimal user action.

API key handling: quick hackathon seeding vs. long-term secure entry.

Performance: keeping overlays snappy on heavy pages; optimizing GIFs to stay light.

🧭 What’s Next

AI-powered feed: personalized rotation by context and recent usage.

Focus integrations: “focus block → reward” routines, Pomodoro-style pacing.

Accessibility: keyboard-first controls, captions, voice selection, reduced-motion.

Local/opt-in telemetry: simple, privacy-respecting metrics to tune default caps.

Community packs: shareable themes, voices, and mini-apps with one-click install.

Built With

Share this project:

Updates