Terminal Steps
Syncs Apple Health steps above the prompt and nudges you to walk.
Illustration. Actual results depend on the mod, terminal and environment.
Install
/plugin marketplace add utpaljaynadiger/claudesteptracker
/plugin install terminal-steps@terminal-steps
/reload-pluginsRun these commands one at a time in a Claude Code session.
claude plugin marketplace add utpaljaynadiger/claudesteptracker
claude plugin install terminal-steps@terminal-stepsThen run /reload-plugins in your session, or start a new session.
Please install the Claude Code mod "Terminal Steps" (https://github.com/utpalJayNadiger/terminal-steps). Before installing, read the Security and Requirements sections of its README and tell me what it reads and writes, which commands it runs, whether it uses the network, and which Claude Code version, OS and terminal it needs. If everything looks fine, run claude plugin marketplace add utpaljaynadiger/claudesteptracker and claude plugin install terminal-steps@terminal-steps, then remind me to run /reload-plugins in my session.Send this to Claude Code so it reads the author’s instructions before installing.
git clone https://github.com/utpalJayNadiger/terminal-steps
cd terminal-steps
claude --plugin-dir .Clone the repository and try it in a local session with --plugin-dir.
What it accesses
Based on the author’s documentation, checked when listed; use claude plugin validate to check for yourself.
Reads
YesReads the daily step file under iCloud Drive/Shortcuts/Steps (path overridable in settings).
Writes files
YesWrites extra/goal/skip state files under ~/.claude/steps/.
Runs commands
UnspecifiedREADME lists no spawned programs; footprint is local file read/write.
Network
NoneIntroduction
Terminal Steps is a Claude Code function-hooks mod that reads today's steps from an iPhone Shortcut file on iCloud Drive and shows goal progress, long-turn walk nudges, streaks and a score grid above the prompt; strict mode can hold prompts when you fall behind. Reads the Steps file under Mobile Documents and writes ~/.claude/steps/. Author states no network calls. Needs Claude Code 2.1.288+, macOS, and your own Shortcut setup. README notes it is adapted from terminal-gym (reps → steps). Preview is illustrative.
Who it is for
- People who live in Claude Code and want a step-goal nudge
Requirements
- Claude Code ≥ 2.1.288
- Platforms · macOS
- Needs an iPhone Shortcut writing steps to iCloud; /steps connect walks you through it.
- Marketplace repo name claudesteptracker redirects to this terminal-steps repo.