imessage

Manage iMessages and SMS via macOS Messages.app using the imsg CLI tool.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/lxh755818-bot/obsidian-vault --skill imessage-lxh755818-bot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/lxh755818-bot/obsidian-vault/tree/main/backup/skills/apple/imessage
Command: npx skills add https://github.com/lxh755818-bot/obsidian-vault --skill imessage-lxh755818-bot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides an efficient way to manage iMessages and SMS directly from the command line on macOS, streamlining communication for users who prefer a non-graphical interface.

Core Features & Use Cases

  • Command-Line Messaging: Interact with iMessages and SMS using simple CLI commands.
  • Chat Management: List, view, and manage individual and group chats.
  • History Access: Retrieve conversation histories with optional attachment information.
  • Message Sending: Send text messages and attachments to phone numbers or Apple IDs.
  • Use Case: Quickly send a message to a colleague's phone number using imsg without opening the Messages.app.

Quick Start

Use the imsg command to send a text message to a specific phone number: imsg send --to "+14155551212" --text "Hello!"

Frequently Asked Questions about imessage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send iMessages and SMS from the macOS command line?

You can send iMessages and SMS from the macOS command line by using the imsg CLI tool to interact directly with the Messages.app, allowing you to text contacts without a graphical interface. Use commands like `imsg send` to deliver messages to phone numbers or Apple IDs.

Can I retrieve iMessage conversation histories and attachments via terminal?

Yes, you can retrieve iMessage conversation histories and attachments via terminal commands. The imsg CLI tool supports listing and viewing individual and group chats, allowing you to access conversation histories with optional attachment information directly on macOS.

Do I need macOS to use the command line messaging tool?

Yes, you need macOS to use this command line messaging tool because it manages iMessages and SMS specifically through the macOS Messages.app. It is designed for users seeking an alternative interface on Apple's operating system.

What is the best way to force SMS delivery instead of iMessage on macOS?

The best way to force SMS delivery instead of iMessage on macOS is by using the imsg CLI tool, which provides specific options to force either iMessage or SMS delivery when sending messages to phone numbers or Apple IDs.

Can I send attachments and manage group chats using terminal commands?

Yes, you can send attachments and manage group chats using terminal commands. The imsg CLI tool supports sending text messages and attachments, and allows you to list, view, and manage both individual and group chats on macOS.