Developers spending too much time in the terminal now have a digital accountability partner. A new open-source plugin called Terminal Steps integrates directly with Claude Code to enforce daily physical activity. The mod, created by developer utpalJayNadiger, displays a persistent step-count band above the prompt and actively blocks new inputs if the user falls behind their daily goal. It represents a growing trend of gamifying developer productivity tools, moving beyond simple metrics to active behavioral enforcement.

The Apple Health Workaround

The technical implementation reveals a persistent headache in the Apple ecosystem: HealthKit lacks a direct Mac or web API. To bridge this gap, the plugin relies on a convoluted but functional data pipeline. An iPhone Shortcut must be configured to read the day's total steps, which are then saved as a text file in iCloud Drive. The Claude Code mod polls this specific file path every two minutes, parsing the step count and timestamp from the two-line text document. This architecture ensures no network calls are made by the plugin itself, keeping the data strictly local via iCloud sync.

Strict Mode and Prompt Blocking

The core feature is "strict mode," which distributes the daily step goal over a ten-hour window starting from the first prompt of the day. The system sets checkpoints every 1,000 steps. If a user falls more than 1,000 steps behind the expected pace for that time window, the plugin freezes the input field. You literally cannot type a new prompt to Claude until you walk off the deficit. To account for the inevitable latency in iPhone-to-Mac syncing, the system fails open if data hasn't updated in 90 minutes, preventing users from being stuck due to technical lag.

Installation and Command Structure

Installation requires Claude Code version 2.1.288 or newer. Users can add the plugin via the marketplace command claude plugin marketplace add utpaljaynadiger/claudesteptracker followed by the install command. The interface offers granular control through slash commands like /steps goal to set targets, /steps add to manually log missed steps, and /steps rest to break the streak without penalty. It is a fork of an existing project called terminal-gym, repurposed from counting gym reps to tracking daily steps.

Key Takeaways

  • Terminal Steps enforces physical activity by blocking Claude Code prompts when step goals are missed.
  • The plugin uses an iPhone Shortcut and iCloud Drive to bypass Apple Health's lack of a Mac API.
  • Strict mode calculates a pace over 10 hours, blocking input if the user falls 1,000 steps behind.
  • Requires Claude Code 2.1.288+ and relies on local file polling rather than network API calls.

The Bottom Line

While the iCloud Shortcut workaround is inelegant, the behavioral enforcement is brilliant. If you need a digital leash to keep you moving while you code, this is the most aggressive productivity hack yet.