react-message

Add an emoji reaction to the message that triggered this conversation.

Critical Rules

1. Use appropriate emoji: Choose an emoji that matches the tone and context of the conversation.
2. Reaction is optional: You don't have to react. Only react when it feels natural.
3. Can be used with or without send-reply: You may react AND send a reply, or just react without replying.
4. Timeout: The script won't run for more than 30 seconds. If it hangs, do stop_bash.
5. Use the correct emoji format: For custom emojis, use the format provided in the emoji list. For standard Unicode emojis, use the emoji character directly (e.g., "👍", "❤️").
6. React only ONCE: Never use this skill more than once. Each time you trigger a reaction, it will replace the previous one, as only one reaction can be displayed at a time. Think carefully and choose just one reaction.

Usage

${HOME}/.agents/skills/react-message/scripts/react-message.ts \
  --session-id "$SESSION_ID" \
  --emoji "👍"

--session-id: Use the session id rendered in your system prompt. $SESSION_ID works only in per-spawn deployments; in shared-process mode it is not set and the skill library resolves the owning session automatically — a mismatched value is never honored.

Examples

React with a Unicode emoji:

${HOME}/.agents/skills/react-message/scripts/react-message.ts \
  --session-id "$SESSION_ID" \
  --emoji "❤️"

React with a custom platform emoji (use the useAsReaction format from the emoji list):

${HOME}/.agents/skills/react-message/scripts/react-message.ts \
  --session-id "$SESSION_ID" \
  --emoji ":custom_emoji_name:"