Sabbk (Nudgling)

Nudgling ("The body double that speaks first") is an autonomous, privacy-first desktop and physical hardware focus companion designed for ADHD brains and developers. THE PROBLEM: THE ADHD PARADOX & INTERNAL CODE DRIFT Traditional productivity tools (Pomodoro timers, Notion boards, website blockers) fail neurodivergent brains because they wait for the user to open them. When executive dysfunction or task-initiation paralysis hits, you don't open a focus app—you drift. Worse, for developers, drift doesn't just happen on YouTube; it happens *inside* the IDE through mid-task scope creep, rabbit holes, and 60-minute uncommitted file pile-ups. In ADHD psychology, "body doubling" (having someone sit beside you while you work) dramatically improves task initiation and sustained attention. Nudgling brings an intelligent, non-judgmental body double to your screen and physical desk. KEY FEATURES & TECHNICAL NOVELTY: 1. Proactive Micro-Nudging ("Speaks First"): Monitors active foreground window titles strictly in volatile RAM (never written to disk). When you drift off-quest, a procedural 24x24 pixel creature on a transparent click-through Electron overlay speaks first—offering ONE concrete micro-action completable in under 2 minutes, with quick actions to mark Done, Park It (save distractions to a vault for later), Snooze, or train the classifier. 2. In-Task Scope Guarding via MCP: Integrates directly with AI coding agents (Claude Code, Cursor, Codex, OpenClaw, Hermes, pi) via a built-in Model Context Protocol (MCP) server (`node bin/nudgling.mjs connect <agent>`). If you ask your coding agent to "also add dark mode" during a bug fix, Nudgling intercepts: "That's new scope. Finish and commit first, or park it." It also catches uncommitted Git pile-ups (10+ modified files over 60 minutes) and same-domain task drift. 3. ADHD-Friendly Gamification: Awards XP strictly for completed micro-steps (never raw seat time), protects consistency with forgiving Streak Shields (so a rough day never resets progress to zero), and provides Web Audio API synthesized robot emotes, expanding flow-combo auras, and unlockable cosmetics. 4. Nudgling Desk (Physical ESP32 + RFID Hardware Companion): Includes open-source C++ firmware for an ESP32 + 1.8" ST7735 TFT display + RC522 RFID reader connected over 115200-baud serial. Users tap physical NFC/RFID cards to start quests, log steps, or trigger "Card Lock Mode"—where drifting past allowance pulses the hardware screen red until you physically walk across the room to tap your Break card. EMPIRICAL RIGOR & VERIFICATION: - 109/109 automated tests passing across brain, classifier, scope guard, rewards, vault, CLI, and MCP server. - 20-minute continuous soak test (2s polling) with zero memory leaks (RAM footprint dropped from 63 MB to 26 MB with 0 crashes). - 16-stage automated E2E GUI self-test driving the live Electron overlay.