TL;DR

  • Terminal Steps는 Apple Health에서 동기화한 걸음 수로 일일 목표를 추적하고, 프롬프트 표시줄·알림·연속 기록·엄격 모드를 제공하는 Claude Code 모드임.
  • Apple Health 데이터는 iPhone 단축어가 읽어 iCloud Drive의 파일에 저장하고, 모드는 해당 파일을 읽어 걸음 수를 표시함.
  • 단축어는 오늘의 걸음 수를 합산하고 날짜와 실행 시각을 기록한 뒤, Steps/<날짜>.txt 파일로 저장하는 방식임.
  • 엄격 모드는 첫 프롬프트부터 기본 10시간 동안 1,000걸음 단위로 목표를 나누며, 유예량보다 뒤처지면 걸을 때까지 입력한 프롬프트를 보류함.
  • 명령어로 목표·동기화·연속 기록·휴식일·엄격 모드를 관리하며, 데이터는 로컬 파일로 읽고 쓰고 네트워크 호출은 없음.

Terminal Steps

  • 에이전트가 다리품을 팔고, 사용자는 발품을 팔도록 구성한 일일 걸음 수 목표 모드임.
  • 프롬프트 위 표시줄에 오늘 걸음 수를 표시하고, 긴 작업을 진행하면 걷도록 안내하며, 연속 기록으로 진행 상황을 추적하고 엄격 모드에서는 목표 미달 시 프롬프트를 보류함.
  • terminal-gym에서 포크했으며, 반복 횟수를 걸음 수로 바꾼 모드임.
  • 설치 명령은 claude plugin marketplace add utpaljaynadiger/claudesteptracker && claude plugin install terminal-steps@terminal-steps임.
  • Claude Code 2.1.288 이상이 필요함.

걸음 수를 Mac으로 가져오는 방법

  • Apple Health에는 Mac 또는 웹 API가 없으므로, iPhone 단축어가 오늘의 합계를 읽어 iCloud Drive에 저장하고 모드가 해당 파일을 읽음.
  • 데이터 흐름은 iPhone Health → Shortcut → iCloud Drive/Shortcuts/Steps/2026-10-03.txt → ~/Library/Mobile Documents/… → 표시줄임.
  • 파일은 두 줄로 구성되며, 첫 줄은 걸음 수이고 둘째 줄은 단축어 실행 시각(ISO 8601)임.
  • 설정 안내는 Claude Code에서 /steps connect를 실행해 확인 가능함.

단축어 만들기(최초 1회)

  • 다음 작업을 순서대로 설정함.
  • 건강 샘플 찾기: 유형은 걸음, 시작 날짜는 오늘, 그룹화 기준은 일로 지정해 iPhone과 Apple Watch의 중복을 제거함.
  • 통계 계산: 합계를 계산함.
  • 숫자 반올림: 일의 자리로 반올림함.
  • 날짜 포맷 지정: 현재 날짜를 사용자 지정 형식 yyyy-MM-dd로 지정함.
  • 텍스트: 반올림한 숫자와 현재 날짜를 각각 새 줄에 기록하며, 현재 날짜는 시각을 포함한 ISO 8601 형식으로 지정함.
  • 파일 저장: 저장 위치 묻기를 끄고, Shortcuts 폴더 아래 Steps/<Formatted Date>.txt 경로에 덮어쓰도록 설정함.
  • 자동화에서 앱 → 열릴 때를 선택하고(Messages, Slack, Safari 등), 즉시 실행으로 설정함.
  • 휴대전화가 잠겨 있는 동안 건강 데이터도 잠기므로, 시간대 기반 자동화보다 앱 실행 트리거가 더 적합함.
  • 단축어를 만든 뒤 ⋯ → 공유 → iCloud 링크 복사를 선택하고 해당 링크를 단축어 링크 설정에 넣으면, /steps connect에서 다른 사용자가 한 번에 설치할 수 있는 링크로 표시됨.

명령어

  • /steps — 오늘의 걸음 수, 동기화 시각, 진행 속도, 연속 기록 확인
  • /steps sync — 휴대전화 파일을 즉시 다시 읽음. 2분마다 자동으로도 확인함.
  • /steps add 2000 — 휴대전화가 놓친 걸음 수 2,000을 추가함.
  • /steps clear — 오늘 추가한 걸음 수를 삭제함.
  • /steps goal 8000 — 일일 목표를 8,000걸음으로 설정함.
  • /steps score — 연속 기록, 28일 그리드, 지난주 기록 확인
  • /steps connect — 단축어 설정 및 연결 상태 확인
  • /steps pass — 휴대전화 동기화를 기다리는 동안 20분간 프롬프트를 허용함. 하루 3회 사용 가능함.
  • /steps rest / /steps rest off — 휴식일을 설정함(연속 기록이 끊김) / 휴식일 설정을 취소함.
  • /steps strict / /steps easy — 엄격 모드를 켬 / 끔.
  • /steps rules / /steps hide — 도움말을 표시함 / 패널을 닫음.

엄격 모드

  • 기본 10시간인 목표 시간대를 첫 프롬프트 시점부터 계산하며, 목표를 1,000걸음 단위의 체크포인트로 나눔.
  • 시작 시점에는 걸음 수 목표가 부과되지 않음. 유예량인 1,000걸음보다 더 뒤처지면 걸을 때까지 입력한 프롬프트가 대기함.
  • 휴대전화 데이터는 늦게 동기화될 수 있으므로 엄격 모드는 실패 시 허용 방식으로 동작함. 휴대전화가 90분 동안 동기화되지 않으면 프롬프트를 보류하지 않음.
  • /steps pass는 걷기를 마친 뒤 다음 동기화가 이뤄질 때까지의 간격을 보완함.

데이터

  • 읽는 파일은 ~/Library/Mobile Documents/iCloud~is~workflow~my~workflows/Documents/Steps/YYYY-MM-DD.txt임. Steps folder 설정으로 경로를 바꿀 수 있음.
  • 쓰는 파일은 ~/.claude/steps/YYYY-MM-DD.{extra,goal,skip}임.
  • 네트워크 호출은 없음.

개발

  • claude plugin test . 명령으로 플러그인을 테스트함.
  • claude plugin validate .claude-plugin/plugin.json 명령으로 플러그인 설정 파일을 검증함.