utpalJayNadiger/terminal-steps
Terminal Steps: a daily step goal inside Claude Code, synced from Apple Health - UtpalJayNadiger/terminal-steps
0 stars · 0 forks
README
🚶 Terminal Steps Your agent's doing the legwork. You do the footwork. A Claude Code mod for a daily step goal, synced from Apple Health. A band above your prompt shows today's steps, long turns nudge you to walk, streaks keep you honest, and strict mode holds your prompts when you fall behind. Forked from terminal-gym (reps → steps). claude plugin marketplace add utpaljaynadiger/claudesteptracker && claude plugin install terminal-steps@terminal-steps Needs Claude Code 2.1.288 or newer. How steps get to your Mac Apple Health has no Mac or web API, so an iPhone Shortcut reads today's total and saves it to iCloud Drive. The mod reads that file: iPhone Health → Shortcut → iCloud Drive/Shortcuts/Steps/2026-10-03.txt → ~/Library/Mobile Documents/… → band
The file is two lines: the step count, then when the Shortcut ran (ISO 8601). Run /steps connect in Claude Code for the setup walkthrough. Build the Shortcut (once)
Find Health Samples: Type Steps, Start Date is today, Group By Day (de-duplicates iPhone + Watch). Calculate Statistics: Sum. Round Number: ones place. Format Date: Current Date, custom yyyy-MM-dd. Text: Rounded Number, newline, Current Date (ISO 8601, include time). Save File: Ask Where to Save off, Shortcuts folder, subpath Steps/<Formatted Date>.txt, Overwrite on.
Then Automation → App → Is Opened (Messages, Slack, Safari…) → Run Immediately. App triggers beat time-of-day ones because Health data is locked while your phone is. Once you've built it, share it (⋯ → Share → Copy iCloud Link) and put the link in the Shortcut link setting: /steps connect then shows it as a one-tap install for anyone else. Commands
Command Does
/steps today's steps, sync time, pace and streak
/steps sync re-read the phone file now (it's also polled every 2 min)
/steps add 2000 add steps the phone missed
/steps clear drop today's added steps
/steps goal 8000 daily goal
/steps score streak, 28-day grid, last week
/steps connect Shortcut setup + connection status
/steps pass 20 min of prompts while the phone catches up (3/day)
/steps rest / rest off rest day (breaks streak) / undo
/steps strict / easy strict mode on / off
/steps rules / hide help / close panels
Strict mode Your goal is spread over a window (10h by default) from your first prompt, in 1,000-step checkpoints. Nothing is due at the start. Fall more than the grace (1,000 steps) behind and typed prompts wait until you walk it off. Phone data lags, so strict mode fails open: if the phone hasn't synced in 90 minutes, nothing is held. /steps pass covers the gap between walking and the next sync. Data
Read: ~/Library/Mobile Documents/iCloud~is~workflow~my~workflows/Documents/Steps/YYYY-MM-DD.txt (override with the Steps folder setting) Written: ~/.claude/steps/YYYY-MM-DD.{extra,goal,skip}
No network calls. Develop claude plugin test . claude plugin validate .claude-plugin/plugin.json