Communitygithub.com

V4TIME/V4SKILL

Envía y recibe iMessages/SMS a través de la línea de comandos `imsg` en macOS.

¿Qué es V4SKILL?

Esta habilidad permite a un agente de IA leer y enviar mensajes iMessage/SMS utilizando la herramienta CLI `imsg` en macOS, integrándose con la aplicación Mensajes del sistema. Es útil para tareas como responder a peticiones de envío de mensajes de texto, consultar el historial de conversaciones o verificar chats recientes. Funciona exclusivamente en macOS con la aplicación Mensajes iniciada sesión y requiere la instalación de `imsg` mediante Homebrew, además de conceder permisos de Acceso Total al Disco y Automatización. La habilidad incluye comandos para listar chats, ver historial, enviar mensajes (con o sin archivos adjuntos, forzando iMessage o SMS) y vigilar nuevos mensajes, pero advierte que no debe usarse para otras plataformas de mensajería, gestión de grupos o envíos masivos sin confirmación explícita del usuario. Su funcionamiento se basa en reglas estrictas de confirmación, verificación de archivos y límite de velocidad para evitar spam.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

iMessage

Usa imsg para leer y enviar iMessages/SMS a través de la aplicación Mensajes de macOS.

Requisitos previos

  • macOS con la aplicación Mensajes iniciada sesión
  • Instalación: brew install steipete/tap/imsg
  • Conceder Acceso Total al Disco para la terminal (Ajustes del Sistema → Privacidad → Acceso Total al Disco)
  • Conceder permiso de Automatización para la aplicación Mensajes cuando se solicite

Cuándo usarlo

  • El usuario pide enviar un iMessage o mensaje de texto
  • Leer el historial de conversaciones de iMessage
  • Revisar chats recientes de la aplicación Mensajes
  • Enviar a números de teléfono o IDs de Apple

Cuándo NO usarlo

  • Mensajes de Telegram/Discord/Slack/WhatsApp → usar el canal de puerta de enlace correspondiente
  • Gestión de chats grupales (añadir/eliminar miembros) → no compatible
  • Mensajería masiva → siempre confirmar primero con el usuario

Referencia rápida

Listar chats

imsg chats --limit 10 --json

Ver historial

# Por ID de chat
imsg history --chat-id 1 --limit 20 --json

# Con información de archivos adjuntos
imsg history --chat-id 1 --limit 20 --attachments --json

Enviar mensajes

# Solo texto
imsg send --to "+14155551212" --text "¡Hola!"

# Con archivo adjunto
imsg send --to "+14155551212" --text "Mira esto" --file /ruta/a/imagen.jpg

# Forzar iMessage o SMS
imsg send --to "+14155551212" --text "Hola" --service imessage
imsg send --to "+14155551212" --text "Hola" --service sms

Vigilar nuevos mensajes

imsg watch --chat-id 1 --attachments

Opciones de servicio

  • --service imessage — Forzar iMessage (requiere que el destinatario tenga iMessage)
  • --service sms — Forzar SMS (burbuja verde)
  • --service auto — Dejar que la aplicación Mensajes decida (predeterminado)

Reglas

  1. Siempre confirmar destinatario y contenido del mensaje antes de enviar
  2. Nunca enviar a números desconocidos sin aprobación explícita del usuario
  3. Verificar que las rutas de archivo existan antes de adjuntar
  4. No hacer spam — limitar la velocidad de envío

Flujo de trabajo de ejemplo

Usuario: "Envía un texto a mamá de que llegaré tarde"

# 1. Buscar el chat de mamá
imsg chats --limit 20 --json | jq '.[] | select(.displayName | contains("Mamá"))'

# 2. Confirmar con el usuario: "Se encontró a Mamá en +1555123456. ¿Enviar 'Llegaré tarde' por iMessage?"

# 3. Enviar después de la confirmación
imsg send --to "+1555123456" --text "Llegaré tarde"

Individual skills in this repo

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

Skills relacionados