Product Introduction
Definition: 30yr-uptime is an open-source Claude Code mod, plugin, and terminal wellness extension designed specifically for developer ergonomics. Categorized under terminal productivity tools and developer health software, it integrates natively into the Claude Code environment via specialized TypeScript-based hook architecture (
hooks/register.tsx).Core Value Proposition: 30yr-uptime exists to combat sedentary developer fatigue and repetitive strain injuries (RSIs) by turning mandatory waiting periods into active recovery sessions. By leveraging idle times when AI code generation runs past a threshold, the tool presents targeted ergonomic movement breaks without requiring external network requests, paid APIs, or token consumption.
Main Features
Intelligent Turn-Time Triggering: The plugin monitors active AI response loops via Claude Code hook events (
turn.startandturn.complete). When a main assistant turn exceeds the configurablewaitSecondsthreshold (default: 15 seconds) and the 45-minute interval timer has elapsed, the system proactively pauses further interruptions to display a contextual physical movement break directly in the CLI interface.Pixel-Art Ergonomic Animation Engine: Featuring 16 distinct movement routines—spanning neck chin-tucks, thoracic chair extensions, wrist stretches, and 20-20-20 eye rests—the mod renders animated pixel character guides inside the terminal using ANSI colors and Unicode layouts. Each routine is optimized for narrow-to-wide viewports, gracefully falling back to text-only mode on terminals under 54 columns or environments enforcing
NO_COLOR.Zero-Token Local Execution Store: Built entirely for privacy and efficiency, the mod operates via local TypeScript execution within the terminal wrapper. It utilizes Claude Code's internal plugin storage exclusively for tracking user pause states (
paused) and custom configuration parameters (settings), sending zero telemetry, prompting zero model calls, and consuming zero LLM tokens.
Problems Solved
Pain Point: Software engineers and terminal power users frequently suffer from forward head posture, carpal tunnel syndrome, digital eye strain, and general musculoskeletal degradation due to uninterrupted, sedentary hours glued to code editors and command-line interfaces.
Target Audience: Full-stack software engineers, AI-assisted developers using Claude Code, terminal enthusiasts, DevOps professionals, and open-source contributors prioritizing long-term physical health over continuous, unbroken terminal focus.
Use Cases: Ideal for developers experiencing long build, test, or AI reasoning loops who want automated, frictionless reminders to stretch, hydrate, and rest their eyes without breaking their terminal workflow context or manually tracking timer intervals.
Unique Advantages
Strengths & Limitations (Pros & Cons):
- Pros: Fully local execution ensures absolute data privacy without token overhead; seamlessly integrates into existing Claude Code workflows; offers a rich library of 16 equipment-free, desk-friendly ergonomic exercises; supports deep customization via the
/break setcommand. - Cons: Strictly limited to users of the Claude Code CLI environment (requires version 2.1.287 or newer); requires a minimum terminal width of 54 columns to render the pixel-art animations properly; relies on user compliance to actually perform the suggested physical movements.
- Pros: Fully local execution ensures absolute data privacy without token overhead; seamlessly integrates into existing Claude Code workflows; offers a rich library of 16 equipment-free, desk-friendly ergonomic exercises; supports deep customization via the
Key Alternatives & Differentiation:
- Standard Pomodoro Apps & Desktop Timers (e.g., Stretchly, Time Out): Generic system-wide break reminders often trigger at inconvenient moments (such as deep debugging sessions) and interrupt mental flow. 30yr-uptime differentiates itself by synchronizing breaks intelligently with natural AI response wait times.
- Standalone Terminal Screen Savers: Unlike visual screen savers that lock the terminal or demand total context switches, 30yr-uptime overlays inline interactive prompts above the active command prompt with simple action buttons (Done, In 5 min, Skip).
Frequently Asked Questions (FAQ)
Question? How do I install 30yr-uptime into Claude Code? Direct, keyword-rich answer: You can install 30yr-uptime by running the marketplace command
/plugin marketplace add https://github.com/mamrezme/30yr-uptime.gitfollowed by/plugin install 30yr-uptime@30yr-uptimein your Claude Code interface, then executing/reload-plugins.Question? Does 30yr-uptime consume my Claude API tokens or send data externally? Direct, keyword-rich answer: No, 30yr-uptime is a 100% local Claude Code mod that makes zero network requests and executes no model calls, meaning it consumes absolute zero tokens and transmits no personal code or prompt data.
Question? Can I disable specific exercises or adjust the break frequency? Direct, keyword-rich answer: Yes, you can fully customize the plugin using the
/break setcommand (for example,/break set squat offto disable specific moves, or/break set intervalMinutes 60to adjust time thresholds between breaks).Question? What happens if my terminal window is too narrow for the pixel character animations? Direct, keyword-rich answer: If your terminal width drops below 54 columns, the plugin automatically falls back to displaying clear text instructions and action buttons only, ensuring full terminal usability without layout breakage.
