imsg SKILL.md skillA

imsg from letta-ai/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add letta-ai/skills/imsg@git:20260422.d32735f

Pins git:20260422.d32735f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
letta-ai/skills
Path
tools/imsg/SKILL.md
Versions recorded
1
Latest version
git:20260422.d32735f, committed Apr 22, 2026
Size
2,127 bytes
Repository stars
153
License
a license file GitHub does not identify

iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# imsg

Use `imsg` to read and send iMessage/SMS via macOS Messages.app.

## Limitations

- Group chat management (adding/removing members) is not supported
- macOS only

## Requirements

- macOS with Messages.app signed in
- Full Disk Access for terminal
- Automation permission for Messages.app (for sending)

## Common Commands

### List Chats

```bash
imsg chats --limit 10 --json
```

### View History

```bash
# By chat ID
imsg history --chat-id 1 --limit 20 --json

# With attachments info
imsg history --chat-id 1 --limit 20 --attachments --json

# Filter by date
imsg history --chat-id 1 --start 2026-01-01T00:00:00Z --json
```

### Watch for New Messages

```bash
imsg watch --chat-id 1 --attachments
imsg watch --chat-id 1 --debounce 250ms
```

### Send Messages

```bash
# Send to phone number
imsg send --to "+14155551212" --text "Hello!"

# Send to existing chat by ID (useful for replies)
imsg send --chat-id 86 --text "Hello!"

# With attachment
imsg send --to "+14155551212" --text "Check this out" --file /path/to/image.jpg

# Specify service
imsg send --to "+14155551212" --text "Hi" --service imessage
imsg send --to "+14155551212" --text "Hi" --service sms
```
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add letta-ai/skills/imsg@sha256:3ae0dcd98a990b6c

The line at the top of this page pins the label git:20260422.d32735f, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_jzzlpvlrbyt6sbns.svg)](https://markdownregistry.com/a/art_jzzlpvlrbyt6sbns)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Apr 22, 2026.

versioncommittedcommitsizeaudit
git:20260422.d32735f latest2026-04-22 d32735f 2,127 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2127 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

letta-ai/skills · 153 stars · license a license file GitHub does not identify · pushed 2026-10-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jzzlpvlrbyt6sbns
GET https://markdownregistry.com/api/v1/resolve?ref=letta-ai/skills/imsg
GET https://markdownregistry.com/api/v1/blob/3ae0dcd98a990b6c69dd71f3c8779ca21ffe97c2c13be1af6d8b3895883b38f7

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from letta-ai/skills

letta-development-guide SKILL.md skill
letta-ai/skills · letta/agent-development/SKILL.md · Comprehensive guide for developing Letta agents, including architecture selection, memory design, model selection, and…
git:20260121.078e325 · audit A · 153 stars
Letta Conversations API SKILL.md skill
letta-ai/skills · letta/conversations/SKILL.md · Guide for using the Letta Conversations API to manage isolated message threads on agents. Use when building multi-user…
git:20260109.6063a75 · audit A · 153 stars
creating-letta-code-channels SKILL.md skill
letta-ai/skills · letta/creating-letta-code-channels/SKILL.md · Builds and debugs Letta Code channels, including first-party channel adapters and dynamic user channel plugins under…
git:20261001.24a73a6 · audit A · 153 stars
letta-fleet-management SKILL.md skill
letta-ai/skills · letta/fleet-management/SKILL.md · Manage Letta AI agent fleets declaratively with kubectl-style CLI. Use when creating, updating, or managing multiple…
git:20260221.84f73cd · audit A · 153 stars
importing-chatgpt-memory SKILL.md skill
letta-ai/skills · letta/importing-chatgpt-memory/SKILL.md · Clone ChatGPT saved memory into Letta, then optionally enrich it with broader conversation history. Designed for a…
git:20260408.2bc2414 · audit A · 153 stars
letta-configuration SKILL.md skill
letta-ai/skills · letta/letta-configuration/SKILL.md · Configure LLM models and providers for Letta agents and servers. Use when setting model handles, adjusting…
git:20260204.eba0c2a · audit A · 153 stars
letta-filesystem-to-memfs SKILL.md skill
letta-ai/skills · letta/letta-filesystem-to-memfs/SKILL.md · Migrates deprecated Letta Filesystem folders/files to MemFS using markdown document corpora, chunking, local lexical…
git:20260513.aeb5473 · audit A · 153 stars
navigating-chatgpt-history SKILL.md skill
letta-ai/skills · letta/navigating-chatgpt-history/SKILL.md · Navigates archived ChatGPT or Claude-style conversation exports and a MemFS reference archive on demand. Use when…
git:20260521.b7217b9 · audit A · 153 stars
self-configuration SKILL.md skill
letta-ai/skills · letta/self-configuration/SKILL.md · Configures Letta agents' own runtime behavior, including model, context window, system prompt, reasoning, conversation…
git:20260618.9da3d97 · audit A · 153 stars
setting-profile-images SKILL.md skill
letta-ai/skills · letta/setting-profile-images/SKILL.md · Sets Letta Desktop and Letta Code agent profile images by writing profile.png into an agent MemFS repository. Use when…
git:20260615.0d50d92 · audit A · 153 stars
skill-development SKILL.md skill
letta-ai/skills · meta/skill-development/SKILL.md · Create and contribute skills to the communal knowledge base. Use when creating new skills, updating existing skills, or…
git:20260204.eba0c2a · audit A · 153 stars
1password SKILL.md skill
letta-ai/skills · tools/1password/SKILL.md · Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or…
git:20260422.af6a950 · audit A · 153 stars

Every file in letta-ai/skills

Other files named imsg

imsg SKILL.md skill
bitterbot-ai/bitterbot-desktop · skills/imsg/SKILL.md · iMessage/SMS CLI for listing chats, history, watch, and sending.
git:20260328.33f9833 · audit A · 2,480 stars
imsg SKILL.md skill
trpc-group/trpc-agent-go · openclaw/skills/imsg/SKILL.md · iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app.
git:20260304.8ebbeae · audit A · 1,890 stars
imsg SKILL.md skill
cowork-os/cowork-os · resources/skills/imsg/SKILL.md · iMessage/SMS CLI for listing chats, history, watch, and sending.
v1.0.0 · audit A · 517 stars
imsg SKILL.md skill
openclaw/nix-openclaw-tools · tools/imsg/skills/imsg/SKILL.md · Use the imsg CLI from OpenClaw agents for iMessage/SMS DMs, groups, replies, reactions, polls, watching, and…
git:20260908.d24bc3c · audit A · 54 stars
imsg SKILL.md skill
metaspartan/cybara · skills/imsg/SKILL.md · iMessage/SMS CLI for listing chats, history, watch, and sending.
git:20260218.a87179d · audit A · 33 stars
imsg SKILL.md skill
pr-e/openclaw-master-skills · skills/imsg/SKILL.md · iMessage/SMS CLI for listing chats, history, watch, and sending.
git:20260311.3e83cee · audit A · 3 stars

Browse by kind, by grade A, or by owner.