using-imessage-max

Using iMessage Max

Overview

Use this skill to choose the right iMessage Max tool sequence for the user's intent.

Start broad when completeness matters, then narrow. Unread-only and activity-only views miss things. Do not let either stand in for a full recent overview unless the user asked for that narrower slice.

When reporting results back to the user, use human chat names and participant names. Treat chat_id values such as chat123 as internal handles for follow-up tool calls and exact sends; do not refer to conversations as "Chat 123" in user-facing prose when chat.name, name, or participant labels are available.

Workflow guide

Broad catch-up or daily sweep

Use this when the user says things like:

• "catch me up on everything I missed"
• "morning sweep"
• "what happened in the last day or two"
• "show me what I should know from my texts"

Default flow:

1. Start with list_chats using a recent window such as since="1d" or since="2d" and sort="recent".
2. Use get_unread as a cross-check for still-unread threads and message-level unread review when needed.
3. Use get_active_conversations only to prioritize which recent threads may deserve attention first.
4. Use get_messages to drill into the chats surfaced by the overview. If you already hold a next_rowid from a previous turn, call get_messages_since with it instead of get_unread.

Why:

• list_chats gives the safest broad preview across recent conversations.
• get_unread is narrower and can miss important chats that were already opened.
• get_active_conversations is also narrower and can miss quiet but important threads.
• list_chats, search, get_unread, and find_chat hide junk and unknown-sender chats by default and report how many in filtered_hidden. Only pass include_filtered=true when the user asks about a message that did not show up.

Targeted lookup

Use this when the user already knows the person, thread, or topic.

• If they know the person or chat identity, start with find_chat.
• If they already know the exact thread, use get_chat_details before opening message history.
• If they know the topic but not the chat, start with search.
• Then use get_messages or get_context to read the relevant section in detail.