Communitygithub.com

V4TIME/V4SKILL

macOS上のMessages.appを使ってiMessage/SMSの送受信を実行します。

V4SKILL とは?

このスキルは、macOSのMessages.appを介してiMessageやSMS(テキストメッセージ)の送受信を可能にします。`imsg` というCLIツールを使用し、チャットの一覧表示、履歴の確認、メッセージの送信(添付ファイル付きも可)、新着メッセージの監視といった機能を提供します。主にmacOS環境での利用を想定しており、送信前に必ずユーザー確認を促すルールが組み込まれているため、誤送信を防止できます。TelegramやDiscordなどの他のメッセージングサービスとは異なり、このスキルはAppleのiMessage/SMSに特化しています。開発者はこのスキルを利用して、スクリプトやAIエージェントから直接、ネイティブなメッセージング機能を操作できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/V4TIME/V4SKILL/tree/HEAD/apple/imessage

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

iMessage

imsg を使用して、macOS Messages.app 経由で iMessage/SMS を読み取り、送信します。

前提条件

  • macOS で Messages.app にサインインしていること
  • インストール: brew install steipete/tap/imsg
  • ターミナルにフルディスクアクセスを許可する(システム設定 → プライバシーとセキュリティ → フルディスクアクセス)
  • 初回実行時にプロンプトが表示されたら、Messages.app への自動化権限を許可する

使用するタイミング

  • ユーザーが iMessage またはテキストメッセージの送信を依頼したとき
  • iMessage の会話履歴を読むとき
  • 最近の Messages.app のチャットを確認するとき
  • 電話番号または Apple ID 宛に送信するとき

使用してはいけないタイミング

  • Telegram/Discord/Slack/WhatsApp のメッセージ → 適切なゲートウェイチャネルを使用する
  • グループチャットの管理(メンバーの追加/削除)→ 非対応
  • 一括/大量メッセージ送信 → 必ず事前にユーザーに確認する

クイックリファレンス

チャット一覧

imsg chats --limit 10 --json

履歴を表示

# チャットIDを指定
imsg history --chat-id 1 --limit 20 --json

# 添付ファイル情報を含める
imsg history --chat-id 1 --limit 20 --attachments --json

メッセージを送信

# テキストのみ
imsg send --to "+14155551212" --text "Hello!"

# 添付ファイル付き
imsg send --to "+14155551212" --text "Check this out" --file /path/to/image.jpg

# iMessage または SMS を強制
imsg send --to "+14155551212" --text "Hi" --service imessage
imsg send --to "+14155551212" --text "Hi" --service sms

新着メッセージの監視

imsg watch --chat-id 1 --attachments

サービスのオプション

  • --service imessage — iMessage を強制(相手が iMessage を利用している場合のみ)
  • --service sms — SMS を強制(緑色のバブル)
  • --service auto — Messages.app に自動選択させる(デフォルト)

ルール

  1. 送信前に必ず受信者とメッセージ内容を確認する
  2. 明示的なユーザーの承認なしに知らない番号に送信しない
  3. 添付する前にファイルパスが存在することを確認する
  4. スパムしない — レート制限を守る

ワークフロー例

ユーザー: 「お母さんに遅れるってテキストして」

# 1. お母さんのチャットを探す
imsg chats --limit 20 --json | jq '.[] | select(.displayName | contains("Mom"))'

# 2. ユーザーに確認: 「お母さん (+1555123456) が見つかりました。'I'll be late' を iMessage で送信しますか?」

# 3. 確認後、送信
imsg send --to "+1555123456" --text "I'll be late"

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

関連スキル