{"slug": "terminal-steps-a-claude-mod-for-a-daily-step-goal-synced-from-apple-health", "title": "Terminal Steps: A Claude mod for a daily step goal, synced from Apple Health", "summary": "A developer released Terminal Steps, a Claude Code plugin that displays a daily step goal above the prompt and holds typed prompts in strict mode when the user falls more than 1,000 steps behind, syncing data from Apple Health via an iPhone Shortcut that writes to iCloud Drive. The plugin requires Claude Code 2.1.288 or newer, is installed via `claude plugin marketplace add utpaljaynadiger/claudesteptracker`, and makes no network calls, reading `~/Library/Mobile Documents/iCloud~is~workflow~my~workflows/Documents/Steps/YYYY-MM-DD.txt` and writing to `~/.claude/steps/YYYY-MM-DD.{extra,goal,skip}`. Strict mode fails open if the phone has not synced in 90 minutes, and `/steps pass` grants 20 minutes of prompts three times per day while the phone catches up.", "body_md": "**Your agent's doing the legwork. You do the footwork.**\n\nA 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.\n\nForked from [terminal-gym](https://github.com/DrumAndCode/terminal-gym) (reps → steps).\n\n```\nclaude plugin marketplace add utpaljaynadiger/claudesteptracker && claude plugin install terminal-steps@terminal-steps\n```\n\nNeeds Claude Code 2.1.288 or newer.\n\nApple 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:\n\n```\niPhone Health → Shortcut → iCloud Drive/Shortcuts/Steps/2026-10-03.txt → ~/Library/Mobile Documents/… → band\n```\n\nThe file is two lines: the step count, then when the Shortcut ran (ISO 8601). Run `/steps connect` in Claude Code for the setup walkthrough.\n\n1. **Find Health Samples** : Type*Steps* , Start Date*is today* ,**Group By *Day*** (de-duplicates iPhone + Watch).\n2. **Calculate Statistics** :*Sum* .\n3. **Round Number** : ones place.\n4. **Format Date** : Current Date, custom`yyyy-MM-dd` .\n5. **Text** : Rounded Number, newline, Current Date (ISO 8601, include time).\n6. **Save File** : Ask Where to Save**off** , Shortcuts folder, subpath`Steps/<Formatted Date>.txt` , Overwrite**on** .\n\nThen **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.\n\nOnce 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.\n\n| Command | Does | \n|---|---|\n| `/steps` | today's steps, sync time, pace and streak | \n| `/steps sync` | re-read the phone file now (it's also polled every 2 min) | \n| `/steps add 2000` | add steps the phone missed | \n| `/steps clear` | drop today's added steps | \n| `/steps goal 8000` | daily goal | \n| `/steps score` | streak, 28-day grid, last week | \n| `/steps connect` | Shortcut setup + connection status | \n| `/steps pass` | 20 min of prompts while the phone catches up (3/day) | \n| `/steps rest` /`rest off` | rest day (breaks streak) / undo | \n| `/steps strict` /`easy` | strict mode on / off | \n| `/steps rules` /`hide` | help / close panels | \n\nYour 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.\n\nPhone 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.\n\n- Read: `~/Library/Mobile Documents/iCloud~is~workflow~my~workflows/Documents/Steps/YYYY-MM-DD.txt` (override with the**Steps folder** setting)\n- Written: `~/.claude/steps/YYYY-MM-DD.{extra,goal,skip}`\n\nNo network calls.\n\n```\nclaude plugin test .\nclaude plugin validate .claude-plugin/plugin.json\n```\n\n", "url": "https://wpnews.pro/news/terminal-steps-a-claude-mod-for-a-daily-step-goal-synced-from-apple-health", "canonical_source": "https://github.com/utpalJayNadiger/terminal-steps", "published_at": "2026-10-05 22:13:10+00:00", "updated_at": "2026-10-05 22:49:01.088022+00:00", "lang": "en", "topics": ["ai-tools", "ai-agents", "developer-tools"], "entities": ["Terminal Steps", "Claude Code", "Apple Health", "Anthropic", "utpaljaynadiger", "terminal-gym", "iCloud Drive", "iPhone Shortcuts"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/terminal-steps-a-claude-mod-for-a-daily-step-goal-synced-from-apple-health", "markdown": "https://wpnews.pro/news/terminal-steps-a-claude-mod-for-a-daily-step-goal-synced-from-apple-health.md", "text": "https://wpnews.pro/news/terminal-steps-a-claude-mod-for-a-daily-step-goal-synced-from-apple-health.txt", "jsonld": "https://wpnews.pro/news/terminal-steps-a-claude-mod-for-a-daily-step-goal-synced-from-apple-health.jsonld"}}