Group conversation management for XMTP agents. Use when creating groups, managing members, setting permissions, or sending welcome messages. Triggers on group creation, member management, or permissions.
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
Manage group conversations, permissions, and members.
Reference these guidelines when:
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Create | CRITICAL | create- |
| 2 | Members | HIGH | members- |
| 3 | Permissions | HIGH | permissions- |
| 4 | Welcome | MEDIUM | welcome- |
create-group - Create new group conversationscreate-dm - Create direct messagesmembers-add - Add members to groupsmembers-remove - Remove members from groupsmembers-get-address - Get member Ethereum addressespermissions-roles - Understand member, admin, super admin rolespermissions-custom - Set custom permission policieswelcome-on-install - Send welcome on agent installationwelcome-new-members - Welcome new group members// Create a group
const group = await agent.createGroupWithAddresses(addresses, {
groupName: "My Group",
groupDescription: "A cool group",
});
// Welcome on new conversations
agent.on("group", async (ctx) => {
await ctx.conversation.sendText("Hello group!");
});
agent.on("dm", async (ctx) => {
await ctx.conversation.sendText("Hello! How can I help?");
});
Read individual rule files for detailed explanations:
rules/create-group.md
rules/members-add.md
rules/permissions-roles.md
rules/welcome-on-install.md
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Core XMTP Agent SDK setup and patterns. Use when creating new agents, handling messages, setting up middleware, or configuring environment variables. Triggers on agent setup, XMTP configuration, message handling, or middleware implementation.
The English summary is being prepared. Showing the original description.
Interactive button-based UI for XMTP agents following XIP-67. Use when creating menus, confirmation dialogs, selection options, or any button-based interaction. Triggers on inline actions, buttons, menus, or ActionBuilder.
The English summary is being prepared. Showing the original description.
File attachment handling for XMTP agents. Use when sending or receiving images, files, or any encrypted remote attachments. Triggers on file upload, image sending, or remote attachment handling.
The English summary is being prepared. Showing the original description.
Patterns for handling commands, validating input, and filtering messages in XMTP agents. Use when implementing slash commands, validators, or message filters. Triggers on command handling, input validation, or type guards.
The English summary is being prepared. Showing the original description.
Token transactions and wallet integration for XMTP agents. Use when sending USDC, creating transaction requests, or handling transaction confirmations. Triggers on USDC transfer, wallet calls, or transaction reference.
The English summary is being prepared. Showing the original description.
ENS and Web3 identity resolution for XMTP agents. Use when resolving domain names, extracting mentions, or fetching Farcaster profiles. Triggers on ENS resolution, Farcaster lookup, or mention extraction.
The English summary is being prepared. Showing the original description.