XMTP reactions

Send and receive emoji reactions, including thinking indicator patterns.

When to apply

Reference these guidelines when:

• Reacting to user messages with emoji
• Showing processing/thinking state
• Receiving and handling reactions
• Implementing acknowledgment patterns

Rule categories by priority

Priority	Category	Impact	Prefix
1	Send	HIGH	send-
2	Receive	HIGH	receive-
3	Patterns	MEDIUM	patterns-

Quick reference

Send (HIGH)

• send-reaction - Send emoji reactions to messages

Receive (HIGH)

• receive-reaction - Handle incoming reactions

Patterns (MEDIUM)

• patterns-thinking - Thinking indicator pattern

Quick start

// Send a reaction
await ctx.conversation.sendReaction({
  reference: ctx.message.id,
  action: "added",
  content: "👍",
  schema: "unicode",
});

// Thinking indicator pattern
await ctx.conversation.sendReaction({
  reference: ctx.message.id,
  action: "added",
  content: "⏳",
  schema: "unicode",
});

// Process...

await ctx.conversation.sendReaction({
  reference: ctx.message.id,
  action: "removed",
  content: "⏳",
  schema: "unicode",
});

How to use

Read individual rule files for detailed explanations:

rules/send-reaction.md
rules/receive-reaction.md
rules/patterns-thinking.md