Communitygithub.com

V4TIME/V4SKILL

iMessages und SMS über das imsg-CLI-Tool unter macOS senden und empfangen.

Was ist V4SKILL?

Diese Fähigkeit ermöglicht es KI-Agenten, über die macOS Messages-App iMessages und SMS zu senden und zu empfangen. Sie nutzt das externe CLI-Tool `imsg` (installierbar via Homebrew), das auf die lokale Nachrichtendatenbank von Apple zugreift. Dadurch können Agenten Chatverläufe auflisten, neue Nachrichten abrufen und Nachrichten an Telefonnummern oder Apple-IDs senden. Die Fähigkeit ist ideal für Szenarien wie das Benachrichtigen von Kontakten oder das Abrufen von Konversationshistorien, jedoch nicht für Gruppen-Chats, Massenversand oder andere Messaging-Plattformen geeignet. Sie erfordert macOS mit angemeldeter und autorisierter Messages-App.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

iMessage

Verwende imsg, um iMessages/SMS über die macOS Messages-App zu lesen und zu senden.

Voraussetzungen

  • macOS mit angemeldeter Messages-App
  • Installation: brew install steipete/tap/imsg
  • Vollzugriff auf das Terminal gewähren (Systemeinstellungen → Datenschutz & Sicherheit → Vollzugriff)
  • Automatisierungsberechtigung für Messages.app erteilen, wenn dazu aufgefordert wird

Verwendung

  • Der Benutzer bittet darum, eine iMessage oder SMS zu senden
  • iMessage-Konversationsverlauf lesen
  • Aktuelle Chats in Messages.app prüfen
  • Senden an Telefonnummern oder Apple-IDs

Nicht verwenden für

  • Telegram/Discord/Slack/WhatsApp-Nachrichten → nutze den entsprechenden Gateway-Kanal
  • Gruppen-Chat-Verwaltung (Mitglieder hinzufügen/entfernen) → nicht unterstützt
  • Massen-/Serienversand → immer zuerst mit dem Benutzer bestätigen

Kurzreferenz

Chats auflisten

imsg chats --limit 10 --json

Verlauf anzeigen

# Nach Chat-ID
imsg history --chat-id 1 --limit 20 --json

# Mit Anhängen
imsg history --chat-id 1 --limit 20 --attachments --json

Nachrichten senden

# Nur Text
imsg send --to "+14155551212" --text "Hallo!"

# Mit Anhang
imsg send --to "+14155551212" --text "Schau dir das an" --file /pfad/zu/bild.jpg

# iMessage oder SMS erzwingen
imsg send --to "+14155551212" --text "Hi" --service imessage
imsg send --to "+14155551212" --text "Hi" --service sms

Auf neue Nachrichten warten

imsg watch --chat-id 1 --attachments

Dienstoptionen

  • --service imessage — iMessage erzwingen (erfordert, dass der Empfänger iMessage hat)
  • --service sms — SMS erzwingen (grüne Blase)
  • --service auto — Messages.app entscheiden lassen (Standard)

Regeln

  1. Empfänger und Nachrichteninhalt vor dem Senden immer bestätigen
  2. Niemals an unbekannte Nummern senden ohne ausdrückliche Zustimmung des Benutzers
  3. Dateipfade vor dem Anhängen prüfen
  4. Nicht spammen – eigene Rate-Limits einhalten

Beispiel-Workflow

Benutzer: "Schick Mama eine SMS, dass ich später komme"

# 1. Mamas Chat finden
imsg chats --limit 20 --json | jq '.[] | select(.displayName | contains("Mama"))'

# 2. Mit Benutzer bestätigen: "Mama unter +1555123456 gefunden. 'Ich komme später' per iMessage senden?"

# 3. Nach Bestätigung senden
imsg send --to "+1555123456" --text "Ich komme später"

Individual skills in this repo

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

Verwandte Skills