SkillAgentSearch skills...

imsg

OpenClaw cross-compiled for Android (ARM64/x86)

Install / Use

npx skills add jin2005-issues/OpenClaw-Android --skill imsg

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

72/100

Supported Platforms

Universal

Our assessment of imsg

imsg scores 72/100 on our quality scale, 3835th of 4,698 Development & Engineering skills we index.

Its SKILL.md is 10 KB long, well organised into 11 sections with 16 code examples: a thorough specification that gives an agent plenty to work with.

It has no GitHub stars yet, so there is no community track record; judge it on its content.

Substance
29/30
Structure
20/20
Description
8/15
Adoption
0/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so imsg is actively maintained.
  • Our last check on 2026-08-30 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 80/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-15. Automated pattern scan on 2026-11-15. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

imsg compared with similar skills

All 4 of these similar skills score higher than imsg; compare them before choosing.

SkillScoreStarsUpdatedFormat
imsg (this skill)by jin2005-issues72049d agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md

Frequently asked questions

How do I install imsg?
Run npx skills add jin2005-issues/OpenClaw-Android --skill imsg. The install tabs above show the steps for each supported agent.
Which AI agents does imsg work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is imsg safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 80/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is imsg still maintained?
The repository was last updated about 2 months ago, so imsg is actively maintained.

name: imsg description: "Use the imsg CLI from OpenClaw agents for iMessage/SMS DMs, groups, replies, reactions, polls, watching, and private-API actions." homepage: https://imsg.to metadata: { "openclaw": { "emoji": "📨", "os": ["darwin"], "requires": { "bins": ["imsg"] }, "install": [ { "id": "brew", "kind": "brew", "formula": "steipete/tap/imsg", "bins": ["imsg"], "label": "Install imsg (brew)", }, ], }, }

imsg

Use imsg when an OpenClaw agent must act through the user's local macOS Messages.app account: inspect iMessage/SMS history, choose the correct DM or group, send messages/files, reply, react, vote in polls, or use private-API iMessage features.

Do not use this skill for Telegram, Signal, WhatsApp, Discord, Slack, or for replying inside the current OpenClaw conversation when the configured channel already routes the reply.

Agent Flow

  1. Resolve the conversation first.
  2. Choose DM, existing group, or new group.
  3. Pick the lowest-capability command that can do the requested action.
  4. Confirm any send or visible state change unless the user already gave exact recipient, content, and action.
  5. Execute with stable identifiers: prefer --chat-id for normal sends/watch/history and --chat chat GUID for bridge actions.

Never infer a recipient from a casual name alone when several chats or handles could match. Show the matched display name, handle(s), group participants, and message text/action before sending.

Host Requirements

  • macOS 14+ with Messages.app signed in for send/react/bridge actions.
  • Private API mode is strongly encouraged for OpenClaw iMessage. It unlocks replies, precise tapbacks, effects, polls, attachment replies, read/typing actions, and group management. Basic mode is a fallback for reads plus plain text/file send.
  • Full Disk Access for the process context that runs imsg or OpenClaw; reads fail without Messages DB access.
  • Automation permission for Messages.app when using public send.
  • Accessibility permission for the process context that runs public imsg react; it uses System Events UI automation. Bridge tapback uses private API instead.
  • Optional Contacts permission for contact-name resolution.
  • SMS sends require Text Message Forwarding from the user's iPhone to this Mac.
  • Linux reads a copied chat.db only; it cannot send, react, launch Messages.app, mark read, or type.

Resolve Targets

Use --json reads. Output is newline-delimited JSON; use jq -s when jq is available, or consume one object per line directly.

imsg chats --limit 25 --json | jq -s
imsg search --query "dinner" --match contains --json | jq -s
imsg history --chat-id 42 --limit 20 --attachments --json | jq -s
imsg group --chat-id 42 --json

Target rules:

  • DM to a phone/email: use imsg send --to when the user gave an exact handle, or after a single unambiguous chat match.
  • Existing DM thread: imsg send --chat-id <id> is safer than re-resolving a name.
  • Existing group: inspect with imsg group --chat-id <id> --json; send with --chat-id, bridge with the chat GUID from group.
  • New group: use chat-create only when the user explicitly asked to create a group or no existing group matches.
  • Ambiguous group names: confirm participants, not just display name.
  • SMS: use --service sms only when requested or when iMessage fallback is not desired. SMS relay requires Text Message Forwarding.

Do not make jq a hard prerequisite for the skill; it is only a convenient formatter for examples.

Capability Choice

Use standard commands for reads, target resolution, and plain sends:

  • Read/list/search/watch: chats, group, history, search, watch
  • Basic text/file send: send
  • Standard tapback to most recent incoming message in a chat: react

Use the private API bridge for the native iMessage actions OpenClaw users normally expect:

  • Rich replies, text formatting, effects, subjects, multipart sends
  • Native Apple Messages polls and poll votes
  • Tapback by message GUID or tapback removal
  • Edit, unsend, delete, notify anyways
  • Read receipts, typing indicators, bridge event watch
  • Group create/name/photo/member/leave/delete/mark actions
  • Account, whois, nickname checks

For OpenClaw channel setup, check bridge availability early:

imsg status --json

If the host supports bridge actions but Messages is not injected yet, ask before running imsg launch. It kills and relaunches Messages.app to inject the bridge, so treat it as a visible state change:

imsg launch
imsg status --json

If SIP, library validation, private entitlement checks, or missing selectors still block the capability, explain that the requested private-API action is unavailable on this host and offer the closest non-bridge action, if one exists. Do not silently downgrade a threaded reply, effect, subject, poll, or GUID-targeted tapback into a plain send/react.

DM Scenarios

Exact handle, basic send:

imsg send --to "+14155551212" --text "On my way" --service auto

Known DM thread:

imsg send --chat-id 42 --text "On my way"
imsg send --chat-id 42 --file /path/to/photo.jpg

Force channel only when the user asks:

imsg send --to "+14155551212" --text "green bubble" --service sms
imsg send --to "+14155551212" --text "iMessage only" --service imessage --no-sms-fallback

Threaded reply, formatting, effects, or attachment reply:

imsg send-rich --chat 'iMessage;-;+15551234567' \
  --reply-to <message-guid> --text "reply text"
imsg send-rich --chat 'iMessage;-;+15551234567' --text 'hello world' \
  --format '[{"start":0,"length":5,"styles":["bold"]}]'
imsg send-rich --chat 'iMessage;-;+15551234567' --text "boom" --effect impact
imsg send-attachment --chat 'iMessage;-;+15551234567' \
  --reply-to <message-guid> --file /path/to/file.jpg

Formatting ranges are UTF-16 positions. Supported styles include bold, italic, underline, and strikethrough; use --format-file for generated JSON.

Group Scenarios

Inspect before acting:

imsg group --chat-id 42 --json
imsg history --chat-id 42 --limit 20 --json | jq -s

Send to an existing group:

imsg send --chat-id 42 --text "Works for me"

Bridge reply or poll in an existing group:

imsg send-rich --chat 'iMessage;+;chat0000' \
  --reply-to <message-guid> --text "replying in thread"
imsg poll send --chat 'iMessage;+;chat0000' \
  --question "Dinner?" --option "Pizza" --option "Sushi"

Create or mutate groups only on explicit request:

imsg chat-create --addresses '+15551111111,+15552222222' --name 'Crew' --text 'gm'
imsg chat-name --chat 'iMessage;+;chat0000' --name 'Renamed'
imsg chat-photo --chat 'iMessage;+;chat0000' --file /path/to/group.jpg
imsg chat-add-member --chat 'iMessage;+;chat0000' --address +15553333333
imsg chat-remove-member --chat 'iMessage;+;chat0000' --address +15553333333
imsg chat-leave --chat 'iMessage;+;chat0000'
imsg chat-delete --chat 'iMessage;+;chat0000'
imsg chat-mark --chat 'iMessage;+;chat0000' --read

Group mutations are highly visible. Confirm the exact group and participant list before changing membership, name, photo, read state, leaving, or deleting.

Reactions and Replies

Public react is limited: it reacts to the most recent incoming message in the chat.

imsg react --chat-id 42 --reaction like
imsg react --chat-id 42 --reaction love
imsg react --chat-id 42 --reaction dislike
imsg react --chat-id 42 --reaction laugh
imsg react --chat-id 42 --reaction emphasis
imsg react --chat-id 42 --reaction question

For a specific message GUID or removal, use bridge tapback:

imsg tapback --chat 'iMessage;-;+15551234567' --message <message-guid> --kind love
imsg tapback --chat 'iMessage;-;+15551234567' --message <message-guid> --kind love --remove

Use send-rich --reply-to <message-guid> for threaded replies. Confirm the referenced message if the user says "that" or "the previous one".

Polls

Native Apple Messages polls require the bridge. Creation needs at least two --option values. Voting requires one of --option-id, --option-index, or --option.

Messages renders only the options on a poll balloon, so current imsg poll send echoes --question as a best-effort plain caption after the poll. Use --comment to override that caption. Do not retry automatically when only the caption fails: the poll may already be delivered.

imsg poll send --chat 'iMessage;-;+15551234567' \
  --question "Dinner?" --option "Pizza" --option "Sushi" --comment "Vote by 5pm"
imsg poll send --chat 'iMessage;+;chat0000' --reply-to <message-guid> \
  --question "Approve?" --option "Yes" --option "No"
imsg poll vote --chat 'iMessage;+;chat0000' \
  --poll <poll-message-guid> --option-id <option-id>

Find poll IDs and options with:

imsg history --chat-id 42 --limit 20 --json | jq -s '.[] | select(.poll != null) | {guid, poll}'

history and watch backfill a title-less inbound native poll's poll.question from its clean caption row. Poll vote rows are poll events, not tapbacks; watch --reactions is not required to see them.

Watch and Long-Running Agents

For a short one-off wait, use watch:

imsg watch --chat-id 42 --since-rowid 9000 --json
imsg watch --chat-id 42 --attachments --convert-attachments --json
imsg watch --chat-id 42 --reactions --json
imsg watch --chat-id 42 --bb-events --json

--since-rowid is exclusive. Without it, watch starts at the newest row. watch uses filesystem events plus a low-frequency polling fallback, so it can catch up after missed SQLite sidecar events. Poll objects appear without --reactions.

For a daemon or multi-chat integration, use imsg rpc. It speaks JSON-RPC 2.0 over stdin/stdout. Inspect imsg status --json for rpc_methods before using newer bridge or poll methods.

Safety Rules

  • Confirm recipient, chat, and content before every send unless the user's request already contains exact values.
  • Confirm visible state changes: read receipts, typing indicators, edits, unsends, deletes, poll votes, tapbacks, group membership, group name/photo, leaving/deleting chats.
  • Never send to unknown numbers or ambiguous contact-name matches without approval.
  • Confirm attachments exist and are the intended files.
  • Prefer E.164 phone numbers; use --region US or another region only when needed for local formats.
  • Use bridge actions for bridge-only semantics, but confirm visible state changes and destructive actions first.

Related Skills

View on GitHub
GitHub Stars0
CategoryDevelopment
Updated1mo ago
Forks0

Trust signals

80/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium1 low