Menu
iMessage/SMS CLI — 대화 조회, 메시지 전송, 실시간 수신 감시 + 에이전트 알림 채널. 어떤 도구에서든 imsg send로 iMessage 알림 가능.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | imsg |
| description | iMessage/SMS CLI — 대화 조회, 메시지 전송, 실시간 수신 감시 + 에이전트 알림 채널. 어떤 도구에서든 imsg send로 iMessage 알림 가능. |
| version | 1.0.0 |
| status | active |
macOS Messages.app을 터미널에서 제어. 대화 조회, 메시지 전송, 실시간 수신 감시. 에이전트/크론/스크립트에서 iMessage 알림 채널로 활용 가능.
✅ USE:
❌ DON'T USE:
message 도구 (channel:telegram)slack 스킬message 도구 (channel:discord)메시지 요청 수신
├─ iMessage/SMS? → YES → imsg 사용
│ → NO → 해당 채널 도구 사용
↓
수신자 확인
├─ 전화번호/이메일 있음? → imsg send --to
├─ chat-id 있음? → imsg send --chat-id
└─ 이름만 있음? → imsg chats --json → 검색 → 확인 후 전송
↓
전송 전 확인
├─ 사용자 직접 요청? → 수신자+내용 확인 후 전송
└─ 에이전트 알림? → 사전 설정된 번호로 즉시 전송
imsg chats [options]
Options:
--limit <N> 표시할 대화 수
--json, -j JSON 출력
--db <path> chat.db 경로 (기본: ~/Library/Messages/chat.db)
-v, --verbose 상세 로깅
Examples:
imsg chats --limit 10 --json
imsg chats --limit 5
JSON 출력 필드: chat_id, displayName, lastMessage, lastMessageDate, service, participants
imsg history [options]
Options:
--chat-id <ID> 대화 ID (chats에서 확인)
--limit <N> 메시지 수
--start <ISO8601> 시작 시간 (inclusive)
--end <ISO8601> 종료 시간 (exclusive)
--participants <handles> 참여자 필터
--attachments 첨부파일 메타데이터 포함
--json, -j JSON 출력
Examples:
imsg history --chat-id 1 --limit 20 --json
imsg history --chat-id 1 --start 2026-03-01T00:00:00Z --attachments --json
imsg history --chat-id 1 --limit 50 --participants "+821012345678"
imsg send [options]
Options:
--to <phone/email> 수신자 (전화번호 또는 이메일)
--chat-id <ID> 대화 ID로 전송
--chat-identifier <str> 대화 식별자
--chat-guid <str> 대화 GUID
--text <message> 메시지 본문
--file <path> 첨부파일 경로
--service <type> imessage | sms | auto (기본: auto)
--region <code> 전화번호 정규화 지역
--json, -j JSON 출력
Examples:
# 텍스트 전송
imsg send --to "+821012345678" --text "안녕하세요!"
# 첨부파일 포함
imsg send --to "+821012345678" --text "보고서입니다" --file ~/reports/daily.pdf
# chat-id로 전송
imsg send --chat-id 42 --text "답장합니다"
# iMessage 강제
imsg send --to "+821012345678" --text "iMessage로" --service imessage
# SMS 강제
imsg send --to "+821012345678" --text "SMS로" --service sms
imsg watch [options]
Options:
--chat-id <ID> 특정 대화만 감시
--participants <handles> 참여자 필터
--since-rowid <ID> 이 rowid 이후부터
--debounce <duration> 이벤트 디바운스 (예: 250ms)
--start <ISO8601> 시작 시간
--end <ISO8601> 종료 시간
--attachments 첨부파일 메타데이터 포함
--json, -j JSON 출력
Examples:
imsg watch --json
imsg watch --chat-id 1 --attachments --debounce 250ms
imsg watch --participants "+821012345678" --json
imsg rpc [options]
# stdin/stdout JSON-RPC 프로토콜 (MCP 서버 등 연동용)
# 성공 알림
imsg send --to "{{NOTIFY_PHONE}}" --text "✅ 작업 완료: 설명"
# 에러 알림
imsg send --to "{{NOTIFY_PHONE}}" --text "🔴 에러: 설명"
# 파일 첨부 알림
imsg send --to "{{NOTIFY_PHONE}}" --text "📊 리포트" --file /path/to/report.pdf
# 성공/실패 분기
some_command \
&& imsg send --to "{{NOTIFY_PHONE}}" --text "✅ 완료" \
|| imsg send --to "{{NOTIFY_PHONE}}" --text "🔴 실패"
# 크론 결과 알림
0 9 * * * /path/to/script.sh && imsg send --to "{{NOTIFY_PHONE}}" --text "📋 크론 완료 $(date)"
# Claude Code 완료 알림
claude --print "작업 내용" && imsg send --to "{{NOTIFY_PHONE}}" --text "Claude Code 완료"
# Codex 완료 알림
codex "작업 내용" && imsg send --to "{{NOTIFY_PHONE}}" --text "Codex 완료"
# ~/.zshrc에 추가
notify() { imsg send --to "{{NOTIFY_PHONE}}" --text "$*"; }
notify-file() { imsg send --to "{{NOTIFY_PHONE}}" --text "$1" --file "$2"; }
# 사용
notify "빌드 완료!"
notify-file "리포트 첨부" ~/report.pdf
{{NOTIFY_PHONE}}으로만 전송 (다른 번호 금지)| 문제 | 원인 | 해결 |
|---|---|---|
command not found | 미설치 | brew install steipete/tap/imsg |
permission denied | Full Disk Access 없음 | 시스템 설정 → Full Disk Access → 터미널 추가 |
| 전송 실패 | Automation 미허용 | 시스템 설정 → 자동화 → Terminal → Messages 체크 |
| Messages 미실행 | Messages.app 꺼짐 | Messages.app 실행 후 재시도 |
| iMessage 미지원 수신자 | 상대방 iMessage 없음 | --service sms 옵션 |
| chat-id 모름 | ID 미확인 | imsg chats --json으로 확인 |
{{NOTIFY_PHONE}}을 TOOLS.md에 기록하여 모든 에이전트가 참조--json 옵션으로 스크립트에서 파싱 가능--debounce 250ms로 중복 이벤트 방지일반화된 팀 오케스트레이션 하네스. "FT 구성", "FT 해보자", "FT 하자" 요청 시 사용 (보조 트리거: "fable-team", "팀 구성", "팀 에이전트 설치", "팀으로 진행" / 로컬 패치는 "FT 업데이트"). 오케스트레이터(sonnet-5 또는 fable-5 ultracode — 세션 시작 시 사용자 선택)는 전달·조율만 — 기획·구현 직접 수행은 orchestration-gate 훅이 물리 차단(선언 아닌 강제). 기획·문제해결은 architect 브레인(sonnet-5 기본 — fable-5는 신규설계·2회 수렴실패 에스컬레이션 예약제, FT 구성 시 기록)이 전담. 라이브 디버깅(관찰의존)은 FT 반려·솔로 권고(허들 0). 설치 인터뷰 + 피처 설계 인터뷰로 프로젝트별 워커를 커스텀 생성한다. 트리거 시 부팅 시퀀스(피처 입력→추천 설계→프리뷰→컨펌)가 강제된다.
tmux + Claude/Codex/OMX session control. "tmux 세션 열어", "claude/codex/omx 세션 만들어", "tmuxc", "tmc", "리모트 세션", "remote session", "프로젝트 세션 생성", "tmux 목록", "tmux 정리", "세션 정리", "세션 증류", "세션 클린업", "세션 복원", "세션 복구", "양방향 메시지", "세션간 메시지" 요청 시 자동 실행. (global) (user)
AI 코딩 에이전트 CLI 툴킷 — 설치·비교·**비대화 실행·자율주행·resume 체인·페르소나 위임**. 지원: Claude Code · Codex · Gemini · OpenCode · Cursor Agent (+ Aider/Amp/Pi 참고). 현재 코딩/채팅 세션 안에서 OTHER 프로바이더 CLI를 비대화로 띄워 자율 주행시키고(dangerous/full-auto/yolo/force), 페르소나(DA/designer/architect)를 주입하고, resume으로 이어간다. 판별 신호는 "현재 세션과 다른 모델/에이전트에 작업·판단을 위임". 다음에서 발동: 다른 모델의 second opinion·적대검증(DA)·설계/아키텍처 패스·cross-check, 바운디드 작업 위임 후 결과 회수, 이전 cross-model 세션 resume, oh-my-*(ulw/ultraplan)·baton·tmuxc 팬아웃, 그리고 이 CLI들의 설치·인증·비교·래핑 가이드. 한국어: "다른 모델로 검증", "DA 돌려", "코덱스한테 시켜", "제미나이 의견", "cross-check", "second opinion 받아줘", "resume 이어서", "codex/gemini/claude 설치", "CLI 비교", "래핑 가이드". Do NOT trigger: 단순 "이거 리팩토링/리뷰해줘"(현재 에이전트가 직접), Cursor IDE 설정, git의 resume/rebase, 무관한 'second opinion' 문서 작성.
Per-project headroom 압축 프록시 토글. "/headroom on", "/headroom off", "/headroom status", "헤드룸 켜", "헤드룸 꺼", "헤드룸 상태" 요청 시 실행. 현재 프로젝트를 enabled-projects.json에 등록/해제해 영구 on/off. 사용자가 프로젝트·크루별로 직접 컨트롤하며 자동 활성화하지 않는다.
cairn 일정·복구 원장 CLI. "마일스톤", "태스크", "일정", "지연/overdue", "간트", "복구 그래프", "spawn/complete/return", "fanout/fanin", "세션 증류 후 복귀점" 관련 작업 시 발동. 결정적 단일 직렬 writer 원장(.cairn/plan.yaml) + git 추적. 멀티에이전트 fan-out 작업의 분기→완료→복귀(return_to/merge_back_to) 계보를 1급으로 소유.
Universal Standard Workflow — 워크트리 + 아카이브 + 작업 메모리 표준. Triggers on `/baton:*` slash commands AND keywords "이어서", "진행", "go", "continue", "next" (resume). MANDATORY before starting any worktree-related work.