이 스킬이 시스템에 하는 일 (설치 전 확인)
- macOS 전용이고 아이폰 문자 동기화가 켜져 있어야 합니다.
- 로컬 메시지 DB(
~/Library/Messages/chat.db)를 읽습니다. 전체 디스크 접근 권한이 필요합니다.- 읽기 전용입니다. 발송 기능이 없습니다.
- 메시지를 외부로 전송하지 않습니다. 전부 로컬에서 처리됩니다.
아이폰 문자 읽기
정본 도구는 ~/bin/imsg다. 맥 메시지 앱이 아이폰과 동기화한
~/Library/Messages/chat.db를 읽기 전용으로 조회한다. 아이폰 문자 전달이 켜져 있어
SMS·RCS·iMessage가 모두 들어온다(2026-08-28 기준 SMS 24,034건, iMessage 1,976건).
반드시 SSH 루프백으로 실행할 것
chat.db는 TCC 보호 대상이라 Aside 샌드박스 안에서는 열리지 않는다.
bash# 샌드박스 안 → 실패 ~/bin/imsg recent # chat.db를 열 수 없습니다 (unable to open database file) # SSH 루프백 → 성공 ssh -o BatchMode=yes localhost '~/bin/imsg recent -n 10'
sshd가 전체 디스크 접근 권한을 이미 갖고 있어서 루프백으로 나가면 읽힌다.
음성메모 파이프라인·카톡(kmsg)과 같은 구조다.
SSH 세션의 PATH에는 ~/bin이 없다. 절대경로 ~/bin/imsg로 호출하거나
export PATH=$HOME/bin:$PATH를 앞에 붙인다.
명령
bashssh localhost '~/bin/imsg recent -n 20' # 최근 메시지 ssh localhost '~/bin/imsg chats -n 20' # 최근 대화 상대 (건수 포함) ssh localhost '~/bin/imsg read 포말 -n 30' # 특정 상대와의 대화 ssh localhost '~/bin/imsg search 계약 -n 20' # 본문 검색 ssh localhost '~/bin/imsg code -n 5 --days 3' # 인증번호만 추출
공통 옵션: --json --days N --me(내가 보낸 것만) --them(받은 것만)
옵션은 서브커맨드 뒤에 붙여도 된다.
인증번호 추출
로그인·본인확인 중 문자 인증이 필요할 때 쓴다. 실측으로 국세청·당근페이·결제선생 문자에서 정확히 뽑는 것을 확인했다.
추출 우선순위는 대괄호 안 숫자 → "인증번호 XXXX" 패턴 → code/OTP 패턴 순이고,
그래도 없으면 6자리·4자리 순으로 고른다. 연도(20XX)와 휴대폰번호는 후보에서 제외한다.
상품명·주문·배송·결제금액 같은 단어가 있으면 광고로 보고 건너뛴다.
구현 메모
- 최신 macOS는 본문을
message.text에 넣지 않고attributedBody(NSKeyedArchiver typedstream)에만 넣는 경우가 많다(최근 500건 중 298건).pytypedstream으로 디코딩하고, 실패하면NSString마커 기반 휴리스틱으로 폴백한다. - 시각은 Apple epoch(2001-01-01 기준 나노초)라
date/1e9 + 978307200으로 변환한다. - 연락처 이름은 주소록
~/Library/Application Support/AddressBook/Sources/*/AddressBook-v22.abcddb의ZABCDPHONENUMBER+ZABCDRECORD에서 가져온다. 번호는+82→0정규화 후 뒤 10자리로 매칭한다. - 파이썬 인터프리터는
/Users/mac/Projects/getback/.venv/bin/python을 shebang으로 쓴다(pytypedstream이 여기 설치돼 있다).
하지 말 것
chat.db에 쓰기 금지. 항상mode=ro로 연다. 메시지 앱이 동시에 쓰고 있어 잠금 충돌이나 손상 위험이 있다.- 문자 내용을 대화창에 통째로 출력하지 말 것. 금융·인증·개인 대화가 섞여 있다. 필요한 건만 골라서 보여주고, 번호는 마스킹한다.
- 발송 기능은 없다. 문자 보내기는 지원하지 않는다(카톡은
kakaotalk-send스킬).
참고
- 카톡 읽기·보내기:
kakaotalk-send스킬 - 같은 TCC/SSH 루프백 구조:
~/.aside/u/0/memory/agent/mac-mini-voice-memo-pipeline.md
