@xmtp/convos-cli 0.1.0 → 0.2.0

package/oclif.manifest.json

@@ -224,7 +224,7 @@
           "required": false
         }
       },
-      "description": "Run an agent server for a conversation.\n\nStarts a long-running process that combines message streaming,\njoin request processing, and stdin command handling into a single\nsession — ideal for AI agents and bots.\n\nIf no conversation ID is provided, creates a new conversation.\nDisplays the QR code invite on stderr so agents can share it.\n\nUses an ndjson (newline-delimited JSON) protocol:\n\nSTDIN commands (one JSON object per line):\n  {\"type\":\"send\",\"text\":\"Hello\"}                        Send a text message\n  {\"type\":\"send\",\"text\":\"Re\",\"replyTo\":\"<id>\"}          Reply to a message\n  {\"type\":\"react\",\"messageId\":\"<id>\",\"emoji\":\"👍\"}       React to a message\n  {\"type\":\"react\",\"messageId\":\"<id>\",\"emoji\":\"👍\",\"action\":\"remove\"}\n  {\"type\":\"attach\",\"file\":\"./photo.jpg\"}                Send a file attachment\n  {\"type\":\"attach\",\"file\":\"./img.jpg\",\"replyTo\":\"<id>\"} Reply with attachment\n  {\"type\":\"remote-attach\",\"url\":\"https://...\",\"contentDigest\":\"...\",\"secret\":\"...\",\"salt\":\"...\",\"nonce\":\"...\",\"contentLength\":123}\n  {\"type\":\"stop\"}                                       Graceful shutdown\n\nSTDOUT events (one JSON object per line):\n  {\"event\":\"ready\",...}         Session started, includes invite URL\n  {\"event\":\"message\",...}       New message received\n  {\"event\":\"member_joined\",...} A member joined via invite\n  {\"event\":\"sent\",...}          Message sent confirmation\n  {\"event\":\"error\",...}         Error occurred\n\nSTDERR: QR code, diagnostic logs (does not interfere with protocol)",
+      "description": "Run an agent server for a conversation.\n\nStarts a long-running process that combines message streaming,\njoin request processing, and stdin command handling into a single\nsession — ideal for AI agents and bots.\n\nIf no conversation ID is provided, creates a new conversation.\nDisplays the QR code invite on stderr so agents can share it.\n\nUses an ndjson (newline-delimited JSON) protocol:\n\nSTDIN commands (one JSON object per line):\n  {\"type\":\"send\",\"text\":\"Hello\"}                        Send a text message\n  {\"type\":\"send\",\"text\":\"Re\",\"replyTo\":\"<id>\"}          Reply to a message\n  {\"type\":\"react\",\"messageId\":\"<id>\",\"emoji\":\"👍\"}       React to a message\n  {\"type\":\"react\",\"messageId\":\"<id>\",\"emoji\":\"👍\",\"action\":\"remove\"}\n  {\"type\":\"attach\",\"file\":\"./photo.jpg\"}                Send a file attachment\n  {\"type\":\"attach\",\"file\":\"./img.jpg\",\"replyTo\":\"<id>\"} Reply with attachment\n  {\"type\":\"remote-attach\",\"url\":\"https://...\",\"contentDigest\":\"...\",\"secret\":\"...\",\"salt\":\"...\",\"nonce\":\"...\",\"contentLength\":123}\n  {\"type\":\"rename\",\"name\":\"New Name\"}                   Rename the conversation\n  {\"type\":\"lock\"}                                       Lock (prevent new joins)\n  {\"type\":\"unlock\"}                                     Unlock (allow new joins)\n  {\"type\":\"explode\"}                                    Explode immediately\n  {\"type\":\"explode\",\"scheduled\":\"2025-03-01T00:00:00Z\"} Schedule explosion\n  {\"type\":\"stop\"}                                       Graceful shutdown\n\nSTDOUT events (one JSON object per line):\n  {\"event\":\"ready\",...}         Session started, includes invite URL\n  {\"event\":\"message\",...}       New message received\n  {\"event\":\"member_joined\",...} A member joined via invite\n  {\"event\":\"sent\",...}          Message sent confirmation\n  {\"event\":\"heartbeat\",...}     Periodic health check\n  {\"event\":\"error\",...}         Error occurred\n\nSTDERR: QR code, diagnostic logs (does not interfere with protocol)",
       "examples": [
         {
           "command": "<%= config.bin %> <%= command.id %> --name \"My Bot\"",
@@ -366,6 +366,15 @@
           "name": "no-invite",
           "allowNo": false,
           "type": "boolean"
+        },
+        "heartbeat": {
+          "description": "Emit heartbeat events every N seconds (0 to disable)",
+          "name": "heartbeat",
+          "default": 0,
+          "hasDynamicHelp": false,
+          "helpValue": "<seconds>",
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -414,6 +423,7 @@
           "type": "boolean"
         }
       },
+      "MAX_RECENT_IDS": 1000,
       "isESM": true,
       "relativePath": [
         "dist",
@@ -422,16 +432,28 @@
         "serve.js"
       ]
     },
-    "conversation:add-members": {
+    "conversations:create": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "The conversation ID",
-          "name": "id",
-          "required": true
+      "args": {},
+      "description": "Create a new Convos conversation.\n\nCreates a new conversation with a fresh per-conversation identity.\nEach conversation gets its own XMTP inbox for privacy isolation\n(per ADR 002).\n\nThis command:\n1. Creates a new identity (or uses an existing unlinked one)\n2. Initializes the XMTP client for that identity\n3. Creates a group conversation\n4. Links the identity to the conversation\n\nThe creator becomes super admin. Others join via invite links.",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %> --name \"Project Team\"",
+          "description": "Create a named conversation"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --name \"Team\" --description \"Team discussion\"",
+          "description": "Create with metadata"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --identity <identity-id>",
+          "description": "Use a pre-created identity"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --name \"Private\" --permissions admin-only --json",
+          "description": "Create admin-only group with JSON output"
         }
-      },
-      "description": "Add members to a conversation by inbox ID.\n\nLow-level member addition. In Convos, members typically join via\ninvite links instead. Requires super admin permissions.",
+      ],
       "flags": {
         "env-file": {
           "description": "Path to .env file",
@@ -501,15 +523,75 @@
           "helpValue": "<version>",
           "multiple": false,
           "type": "option"
+        },
+        "name": {
+          "description": "Conversation name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "helpValue": "<name>",
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "Conversation description",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "helpValue": "<description>",
+          "multiple": false,
+          "type": "option"
+        },
+        "image-url": {
+          "description": "Conversation image URL",
+          "name": "image-url",
+          "hasDynamicHelp": false,
+          "helpValue": "<url>",
+          "multiple": false,
+          "type": "option"
+        },
+        "permissions": {
+          "description": "Permission preset",
+          "name": "permissions",
+          "default": "all-members",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "all-members",
+            "admin-only"
+          ],
+          "type": "option"
+        },
+        "identity": {
+          "description": "Use an existing unlinked identity ID",
+          "name": "identity",
+          "hasDynamicHelp": false,
+          "helpValue": "<id>",
+          "multiple": false,
+          "type": "option"
+        },
+        "label": {
+          "description": "Local label for the identity",
+          "name": "label",
+          "hasDynamicHelp": false,
+          "helpValue": "<label>",
+          "multiple": false,
+          "type": "option"
+        },
+        "profile-name": {
+          "description": "Profile display name for this conversation",
+          "name": "profile-name",
+          "hasDynamicHelp": false,
+          "helpValue": "<name>",
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:add-members",
+      "id": "conversations:create",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "enableJsonFlag": false,
       "commonFlags": {
         "env-file": {
@@ -553,20 +635,38 @@
       "relativePath": [
         "dist",
         "commands",
-        "conversation",
-        "add-members.js"
+        "conversations",
+        "create.js"
       ]
     },
-    "conversation:consent-state": {
+    "conversations:join": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "The conversation ID",
-          "name": "id",
+        "invite": {
+          "description": "Invite slug or URL",
+          "name": "invite",
           "required": true
         }
       },
-      "description": "Get the consent state of a conversation.",
+      "description": "Join a conversation using an invite slug or URL.\n\nImplements the Convos join flow (per ADR 001):\n\n1. Parse and validate the invite (verify signature, check expiration)\n2. Create a new per-conversation identity for this conversation\n3. Send the invite slug as a DM to the creator's inbox\n4. Wait for the creator's client to process the join request and\n   add this identity to the conversation\n5. Link the identity to the conversation once joined\n\nThe creator's client (iOS app or another CLI instance running\n'convos conversations process-join-requests') must be online to\nprocess the join request.\n\nAccepts either a raw invite slug or a full URL containing the\nslug as query parameter 'i'.",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %> <invite-slug>",
+          "description": "Join using a raw invite slug"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> \"https://popup.convos.org/v2?i=<slug>\"",
+          "description": "Join using a full invite URL"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> <slug> --no-wait",
+          "description": "Send join request without waiting for acceptance"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> <slug> --timeout 120 --json",
+          "description": "Wait up to 2 minutes for acceptance"
+        }
+      ],
       "flags": {
         "env-file": {
           "description": "Path to .env file",
@@ -636,11 +736,50 @@
           "helpValue": "<version>",
           "multiple": false,
           "type": "option"
+        },
+        "no-wait": {
+          "description": "Send the join request but don't wait for the creator to accept",
+          "name": "no-wait",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Seconds to wait for acceptance (default: 60)",
+          "name": "timeout",
+          "default": 60,
+          "hasDynamicHelp": false,
+          "helpValue": "<seconds>",
+          "multiple": false,
+          "type": "option"
+        },
+        "label": {
+          "description": "Local label for the new identity",
+          "name": "label",
+          "hasDynamicHelp": false,
+          "helpValue": "<label>",
+          "multiple": false,
+          "type": "option"
+        },
+        "profile-name": {
+          "description": "Profile display name for this conversation",
+          "name": "profile-name",
+          "hasDynamicHelp": false,
+          "helpValue": "<name>",
+          "multiple": false,
+          "type": "option"
+        },
+        "identity": {
+          "description": "Use an existing unlinked identity instead of creating one",
+          "name": "identity",
+          "hasDynamicHelp": false,
+          "helpValue": "<id>",
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:consent-state",
+      "id": "conversations:join",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -688,37 +827,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "conversation",
-        "consent-state.js"
+        "conversations",
+        "join.js"
       ]
     },
-    "conversation:download-attachment": {
+    "conversations:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "The conversation ID",
-          "name": "id",
-          "required": true
-        },
-        "message-id": {
-          "description": "The message ID of the attachment",
-          "name": "message-id",
-          "required": true
-        }
-      },
-      "description": "Download an attachment from a message.\n\nDownloads an attachment message and saves it to disk. Handles both\ninline attachments and remote (encrypted) attachments transparently.\n\nFor inline attachments, the content is written directly to disk.\n\nFor remote attachments, the encrypted payload is fetched from the URL\nembedded in the message, decrypted using the keys in the message, and\nthe decrypted content is saved to disk.\n\nThe output filename is determined by (in order of priority):\n1. The --output flag (explicit path)\n2. The filename from the message metadata\n3. Auto-generated from message ID + MIME type extension\n\nUse --raw to save the encrypted payload without decrypting (remote\nattachments only).",
+      "args": {},
+      "description": "List all Convos conversations.\n\nLists conversations across all per-conversation identities.\nEach conversation is associated with its own XMTP identity.\n\nUse --sync to fetch the latest state from the network.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> <message-id>",
-          "description": "Download attachment (auto-names from message metadata)"
+          "command": "<%= config.bin %> <%= command.id %>",
+          "description": "List all conversations"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> <message-id> --output ./photo.jpg",
-          "description": "Download to a specific path"
+          "command": "<%= config.bin %> <%= command.id %> --sync",
+          "description": "Sync from network then list"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> <message-id> --raw",
-          "description": "Save the encrypted payload without decrypting (remote only)"
+          "command": "<%= config.bin %> <%= command.id %> --json",
+          "description": "Output as JSON"
         }
       ],
       "flags": {
@@ -791,23 +919,8 @@
           "multiple": false,
           "type": "option"
         },
-        "output": {
-          "char": "o",
-          "description": "Output file path (default: auto-generated from metadata)",
-          "name": "output",
-          "hasDynamicHelp": false,
-          "helpValue": "<path>",
-          "multiple": false,
-          "type": "option"
-        },
-        "raw": {
-          "description": "Save encrypted payload without decrypting (remote attachments only)",
-          "name": "raw",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "sync": {
-          "description": "Sync conversation from network before downloading",
+          "description": "Sync each identity from network before listing",
           "name": "sync",
           "allowNo": false,
           "type": "boolean"
@@ -815,7 +928,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:download-attachment",
+      "id": "conversations:list",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -863,28 +976,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "conversation",
-        "download-attachment.js"
+        "conversations",
+        "list.js"
       ]
     },
-    "conversation:explode": {
+    "conversations:process-join-requests": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "The conversation ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Explode (permanently destroy) a conversation.\n\nSends an ExplodeSettings message to notify all members, updates the\ngroup metadata with the expiration timestamp, removes all members,\nthen deletes the local identity including wallet key, database\nencryption key, and XMTP database. This is irreversible.\n\nPer ADR 004: destroying the per-conversation identity destroys the\ncryptographic material needed to decrypt messages. Recovery is\nimpossible.\n\nSteps:\n1. Send ExplodeSettings message (notifies iOS/other clients)\n2. Update group metadata with expiresAtUnix\n3. Remove all other members from the XMTP group\n4. Delete the local identity (private keys + database)\n\nOnly the conversation creator (super admin) should explode.",
+      "args": {},
+      "description": "Process pending join requests for all conversations.\n\nScans DMs for each identity looking for join requests (text messages\ncontaining signed invite slugs). When a valid join request is found:\n\n1. Verify the invite signature\n2. Decrypt the conversation token to get the conversation ID\n3. Verify the creator inbox ID matches\n4. Add the requester to the conversation\n5. Block invalid/spam requests\n\nWithout --watch, processes all pending DMs and exits.\nWith --watch, streams DM messages in real-time and processes\njoin requests as they arrive (recommended for always-on usage).",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --force",
-          "description": "Explode a conversation immediately"
+          "command": "<%= config.bin %> <%= command.id %>",
+          "description": "Process all pending join requests"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --scheduled \"2025-03-01T00:00:00Z\"",
-          "description": "Schedule a conversation to explode at a specific time"
+          "command": "<%= config.bin %> <%= command.id %> --watch",
+          "description": "Continuously stream and process join requests in real-time"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --conversation <id>",
+          "description": "Process join requests for a specific conversation only"
         }
       ],
       "flags": {
@@ -957,25 +1068,24 @@
           "multiple": false,
           "type": "option"
         },
-        "force": {
-          "char": "f",
-          "description": "Skip confirmation prompt",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
+        "watch": {
+          "description": "Stream DM messages in real-time and process join requests as they arrive",
+          "name": "watch",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "scheduled": {
-          "description": "Schedule explosion for a future date (ISO8601). If omitted, explodes immediately.",
-          "name": "scheduled",
-          "required": false,
+        "conversation": {
+          "description": "Only process requests for this conversation ID",
+          "name": "conversation",
           "hasDynamicHelp": false,
+          "helpValue": "<id>",
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:explode",
+      "id": "conversations:process-join-requests",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -1023,24 +1133,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "conversation",
-        "explode.js"
+        "conversations",
+        "process-join-requests.js"
       ]
     },
-    "conversation:info": {
+    "conversations:sync": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "The conversation ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get detailed information about a conversation.\n\nResolves the per-conversation identity and shows full details\nincluding members, permissions, metadata, and identity info.",
+      "args": {},
+      "description": "Sync all conversations from the network.\n\nSynchronizes every linked identity with the XMTP network.\nFetches new messages and membership changes for all conversations.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id>",
-          "description": "Get conversation details"
+          "command": "<%= config.bin %> <%= command.id %>",
+          "description": "Sync all conversations"
         }
       ],
       "flags": {
@@ -1116,7 +1220,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:info",
+      "id": "conversations:sync",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -1164,36 +1268,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "conversation",
-        "info.js"
+        "conversations",
+        "sync.js"
       ]
     },
-    "conversation:invite": {
+    "identity:create": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "The conversation ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Generate an invite link for a conversation.\n\nCreates a cryptographic invite slug that others can use to request\nto join this conversation (per ADR 001).\n\nThe invite contains:\n- An encrypted conversation ID (only the creator can decrypt)\n- The creator's inbox ID (for routing the join request DM)\n- An invite tag (for verification and revocation)\n- Optional metadata (name, description)\n- A secp256k1 ECDSA signature\n\nDisplays a QR code in the terminal that can be scanned by the\nConvos app. The QR code encodes the full invite URL.\n\nInvite URLs use the format:\n- Dev:        dev.convos.org/v2?i=<slug>\n- Production: popup.convos.org/v2?i=<slug>",
+      "args": {},
+      "description": "Create a new Convos identity.\n\nGenerates a new wallet key and database encryption key for use with\na single conversation. Each conversation gets its own identity for\nmaximum privacy (per ADR 002).\n\nYou can optionally set a label (local-only) and profile name (shared\nwith conversation members per ADR 005).",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id>",
-          "description": "Generate an invite with QR code (default)"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --no-qr",
-          "description": "Generate an invite without QR code"
+          "command": "<%= config.bin %> <%= command.id %>",
+          "description": "Create a new identity"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --expires-in 3600",
-          "description": "Generate an invite that expires in 1 hour"
+          "command": "<%= config.bin %> <%= command.id %> --label \"Work Chat\"",
+          "description": "Create with a local label"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --single-use --json",
-          "description": "Generate a single-use invite with JSON output"
+          "command": "<%= config.bin %> <%= command.id %> --label \"Team\" --profile-name \"Alice\"",
+          "description": "Create with label and profile name"
         }
       ],
       "flags": {
@@ -1266,36 +1360,26 @@
           "multiple": false,
           "type": "option"
         },
-        "qr": {
-          "description": "Display a QR code in the terminal",
-          "name": "qr",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "expires-in": {
-          "description": "Invite expires in N seconds from now",
-          "name": "expires-in",
+        "label": {
+          "description": "Local label for this identity (not shared)",
+          "name": "label",
           "hasDynamicHelp": false,
-          "helpValue": "<seconds>",
+          "helpValue": "<label>",
           "multiple": false,
           "type": "option"
         },
-        "single-use": {
-          "description": "Invite expires after first use",
-          "name": "single-use",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "include-metadata": {
-          "description": "Include conversation name/description in invite",
-          "name": "include-metadata",
-          "allowNo": false,
-          "type": "boolean"
+        "profile-name": {
+          "description": "Profile display name (shared with conversation members)",
+          "name": "profile-name",
+          "hasDynamicHelp": false,
+          "helpValue": "<name>",
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:invite",
+      "id": "identity:create",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -1343,28 +1427,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "conversation",
-        "invite.js"
+        "identity",
+        "create.js"
       ]
     },
-    "conversation:lock": {
+    "identity:info": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "The conversation ID",
+          "description": "The identity ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Lock or unlock a conversation.\n\nLocking prevents new members from joining (per ADR 006) by:\n1. Rotating the invite tag (cryptographically invalidates all existing invites)\n2. Setting the XMTP addMember permission to 'deny'\n\nUnlocking restores the ability to add members. Previously shared\ninvites remain invalid — generate new ones after unlocking.\n\nOnly super admins can lock/unlock.",
+      "description": "Display detailed information about an identity.\n\nShows wallet address, XMTP inbox ID, linked conversation, profile\nsettings, and XMTP client details. Creates and registers the XMTP\nclient if not yet registered.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id>",
-          "description": "Lock a conversation"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --unlock",
-          "description": "Unlock a conversation"
+          "command": "<%= config.bin %> <%= command.id %> <identity-id>",
+          "description": "Show identity details"
         }
       ],
       "flags": {
@@ -1436,24 +1516,11 @@
           "helpValue": "<version>",
           "multiple": false,
           "type": "option"
-        },
-        "unlock": {
-          "description": "Unlock instead of locking",
-          "name": "unlock",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "force": {
-          "char": "f",
-          "description": "Skip confirmation prompt",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:lock",
+      "id": "identity:info",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -1501,24 +1568,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "conversation",
-        "lock.js"
+        "identity",
+        "info.js"
       ]
     },
-    "conversation:members": {
+    "identity:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "The conversation ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "List members of a conversation.\n\nShows all members with their inbox IDs, identifiers, and permission levels.",
+      "args": {},
+      "description": "List all Convos identities.\n\nEach Convos conversation uses its own XMTP identity (inbox) for privacy.\nThis command shows all identities, including which conversation each is\nlinked to.\n\nIdentities without a conversation ID are \"unlinked\" — available for\nuse with new conversations.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id>",
-          "description": "List members"
+          "command": "<%= config.bin %> <%= command.id %>",
+          "description": "List all identities"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> --json",
+          "description": "Output as JSON"
         }
       ],
       "flags": {
@@ -1594,7 +1659,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:members",
+      "id": "identity:list",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -1642,28 +1707,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "conversation",
-        "members.js"
+        "identity",
+        "list.js"
       ]
     },
-    "conversation:messages": {
+    "identity:remove": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "The conversation ID",
+          "description": "The identity ID to remove",
           "name": "id",
           "required": true
         }
       },
-      "description": "List messages in a conversation.\n\nRetrieves messages using the per-conversation identity.\nSupports filtering, pagination, and sorting.",
+      "description": "Remove an identity and all associated data.\n\nPermanently deletes the identity's wallet key, database encryption key,\nXMTP database files, and all local data. This is irreversible.\n\nPer ADR 002 and ADR 004: destroying an identity destroys the\ncryptographic material needed to participate in its conversation.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id>",
-          "description": "List messages"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --sync --limit 10",
-          "description": "Sync and show last 10 messages"
+          "command": "<%= config.bin %> <%= command.id %> <identity-id> --force",
+          "description": "Remove an identity"
         }
       ],
       "flags": {
@@ -1736,129 +1797,156 @@
           "multiple": false,
           "type": "option"
         },
-        "sync": {
-          "description": "Sync from network before listing",
-          "name": "sync",
+        "force": {
+          "char": "f",
+          "description": "Skip confirmation prompt",
+          "name": "force",
           "allowNo": false,
           "type": "boolean"
-        },
-        "limit": {
-          "description": "Maximum number of messages",
-          "name": "limit",
-          "hasDynamicHelp": false,
-          "helpValue": "<number>",
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "identity:remove",
+      "pluginAlias": "@xmtp/convos-cli",
+      "pluginName": "@xmtp/convos-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "commonFlags": {
+        "env-file": {
+          "description": "Path to .env file",
+          "helpValue": "<path>",
+          "input": [],
           "multiple": false,
           "type": "option"
         },
-        "direction": {
-          "description": "Sort direction",
-          "name": "direction",
-          "default": "descending",
-          "hasDynamicHelp": false,
-          "multiple": false,
+        "env": {
           "options": [
-            "ascending",
-            "descending"
+            "local",
+            "dev",
+            "production"
           ],
-          "type": "option"
-        },
-        "sent-before": {
-          "description": "Only messages sent before this timestamp (nanoseconds)",
-          "name": "sent-before",
-          "hasDynamicHelp": false,
-          "helpValue": "<ns>",
+          "description": "XMTP environment",
+          "input": [],
           "multiple": false,
           "type": "option"
         },
-        "sent-after": {
-          "description": "Only messages sent after this timestamp (nanoseconds)",
-          "name": "sent-after",
-          "hasDynamicHelp": false,
-          "helpValue": "<ns>",
+        "gateway-host": {
+          "description": "Custom gateway URL",
+          "helpValue": "<url>",
+          "input": [],
           "multiple": false,
           "type": "option"
         },
-        "delivery-status": {
-          "description": "Filter by delivery status",
-          "name": "delivery-status",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "unpublished",
-            "published",
-            "failed"
-          ],
-          "type": "option"
+        "json": {
+          "description": "Format output as JSON",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "kind": {
-          "description": "Filter by message kind",
-          "name": "kind",
+        "verbose": {
+          "description": "Show additional diagnostic information",
+          "default": false,
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "identity",
+        "remove.js"
+      ]
+    },
+    "conversation:add-members": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "The conversation ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Add members to a conversation by inbox ID.\n\nLow-level member addition. In Convos, members typically join via\ninvite links instead. Requires super admin permissions.",
+      "flags": {
+        "env-file": {
+          "description": "Path to .env file",
+          "name": "env-file",
           "hasDynamicHelp": false,
+          "helpValue": "<path>",
           "multiple": false,
-          "options": [
-            "application",
-            "membership-change"
-          ],
           "type": "option"
         },
-        "content-type": {
-          "description": "Filter by content type (repeatable)",
-          "name": "content-type",
+        "env": {
+          "description": "XMTP environment",
+          "name": "env",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "options": [
-            "actions",
-            "attachment",
-            "custom",
-            "group-membership-change",
-            "group-updated",
-            "intent",
-            "leave-request",
-            "markdown",
-            "multi-remote-attachment",
-            "reaction",
-            "read-receipt",
-            "remote-attachment",
-            "reply",
-            "text",
-            "transaction-reference",
-            "wallet-send-calls"
+            "local",
+            "dev",
+            "production"
           ],
           "type": "option"
         },
-        "exclude-content-type": {
-          "description": "Exclude content type (repeatable)",
-          "name": "exclude-content-type",
+        "gateway-host": {
+          "description": "Custom gateway URL",
+          "name": "gateway-host",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "helpValue": "<url>",
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Format output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "description": "Show additional diagnostic information",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "log-level": {
+          "description": "Logging level",
+          "name": "log-level",
+          "hasDynamicHelp": false,
+          "multiple": false,
           "options": [
-            "actions",
-            "attachment",
-            "custom",
-            "group-membership-change",
-            "group-updated",
-            "intent",
-            "leave-request",
-            "markdown",
-            "multi-remote-attachment",
-            "reaction",
-            "read-receipt",
-            "remote-attachment",
-            "reply",
-            "text",
-            "transaction-reference",
-            "wallet-send-calls"
+            "off",
+            "error",
+            "warn",
+            "info",
+            "debug",
+            "trace"
           ],
           "type": "option"
+        },
+        "structured-logging": {
+          "description": "Enable structured JSON logging",
+          "name": "structured-logging",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "app-version": {
+          "description": "App version string",
+          "name": "app-version",
+          "hasDynamicHelp": false,
+          "helpValue": "<version>",
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:messages",
+      "id": "conversation:add-members",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
       "enableJsonFlag": false,
       "commonFlags": {
         "env-file": {
@@ -1903,10 +1991,10 @@
         "dist",
         "commands",
         "conversation",
-        "messages.js"
+        "add-members.js"
       ]
     },
-    "conversation:permissions": {
+    "conversation:consent-state": {
       "aliases": [],
       "args": {
         "id": {
@@ -1915,7 +2003,7 @@
           "required": true
         }
       },
-      "description": "View permissions for a conversation.",
+      "description": "Get the consent state of a conversation.",
       "flags": {
         "env-file": {
           "description": "Path to .env file",
@@ -1989,7 +2077,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:permissions",
+      "id": "conversation:consent-state",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -2038,27 +2126,36 @@
         "dist",
         "commands",
         "conversation",
-        "permissions.js"
+        "consent-state.js"
       ]
     },
-    "conversation:profiles": {
+    "conversation:download-attachment": {
       "aliases": [],
       "args": {
         "id": {
           "description": "The conversation ID",
           "name": "id",
           "required": true
+        },
+        "message-id": {
+          "description": "The message ID of the attachment",
+          "name": "message-id",
+          "required": true
         }
       },
-      "description": "List member profiles in a conversation.\n\nShows display names and avatar URLs for all members who have set\na profile in this conversation. Profiles are stored in the group's\nmetadata and are visible to all members (ADR 005).\n\nMembers without a profile appear as anonymous with just their inbox ID.",
+      "description": "Download an attachment from a message.\n\nDownloads an attachment message and saves it to disk. Handles both\ninline attachments and remote (encrypted) attachments transparently.\n\nFor inline attachments, the content is written directly to disk.\n\nFor remote attachments, the encrypted payload is fetched from the URL\nembedded in the message, decrypted using the keys in the message, and\nthe decrypted content is saved to disk.\n\nThe output filename is determined by (in order of priority):\n1. The --output flag (explicit path)\n2. The filename from the message metadata\n3. Auto-generated from message ID + MIME type extension\n\nUse --raw to save the encrypted payload without decrypting (remote\nattachments only).",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id>",
-          "description": "List all member profiles"
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> <message-id>",
+          "description": "Download attachment (auto-names from message metadata)"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --json",
-          "description": "List profiles as JSON"
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> <message-id> --output ./photo.jpg",
+          "description": "Download to a specific path"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> <message-id> --raw",
+          "description": "Save the encrypted payload without decrypting (remote only)"
         }
       ],
       "flags": {
@@ -2130,11 +2227,32 @@
           "helpValue": "<version>",
           "multiple": false,
           "type": "option"
+        },
+        "output": {
+          "char": "o",
+          "description": "Output file path (default: auto-generated from metadata)",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "helpValue": "<path>",
+          "multiple": false,
+          "type": "option"
+        },
+        "raw": {
+          "description": "Save encrypted payload without decrypting (remote attachments only)",
+          "name": "raw",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "sync": {
+          "description": "Sync conversation from network before downloading",
+          "name": "sync",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:profiles",
+      "id": "conversation:download-attachment",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -2183,10 +2301,10 @@
         "dist",
         "commands",
         "conversation",
-        "profiles.js"
+        "download-attachment.js"
       ]
     },
-    "conversation:remove-members": {
+    "conversation:explode": {
       "aliases": [],
       "args": {
         "id": {
@@ -2195,7 +2313,17 @@
           "required": true
         }
       },
-      "description": "Remove members from a conversation. Requires super admin permissions.",
+      "description": "Explode (permanently destroy) a conversation.\n\nSends an ExplodeSettings message to notify all members, updates the\ngroup metadata with the expiration timestamp, removes all members,\nthen deletes the local identity including wallet key, database\nencryption key, and XMTP database. This is irreversible.\n\nPer ADR 004: destroying the per-conversation identity destroys the\ncryptographic material needed to decrypt messages. Recovery is\nimpossible.\n\nSteps:\n1. Send ExplodeSettings message (notifies iOS/other clients)\n2. Update group metadata with expiresAtUnix\n3. Remove all other members from the XMTP group\n4. Delete the local identity (private keys + database)\n\nOnly the conversation creator (super admin) should explode.",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --force",
+          "description": "Explode a conversation immediately"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --scheduled \"2025-03-01T00:00:00Z\"",
+          "description": "Schedule a conversation to explode at a specific time"
+        }
+      ],
       "flags": {
         "env-file": {
           "description": "Path to .env file",
@@ -2265,15 +2393,30 @@
           "helpValue": "<version>",
           "multiple": false,
           "type": "option"
+        },
+        "force": {
+          "char": "f",
+          "description": "Skip confirmation prompt",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "scheduled": {
+          "description": "Schedule explosion for a future date (ISO8601). If omitted, explodes immediately.",
+          "name": "scheduled",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:remove-members",
+      "id": "conversation:explode",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "enableJsonFlag": false,
       "commonFlags": {
         "env-file": {
@@ -2318,36 +2461,23 @@
         "dist",
         "commands",
         "conversation",
-        "remove-members.js"
+        "explode.js"
       ]
     },
-    "conversation:send-attachment": {
+    "conversation:info": {
       "aliases": [],
       "args": {
         "id": {
           "description": "The conversation ID",
           "name": "id",
           "required": true
-        },
-        "file": {
-          "description": "Path to the file to send",
-          "name": "file",
-          "required": true
         }
       },
-      "description": "Send a file attachment to a conversation.\n\nReads a file from disk and sends it as an attachment message. Small\nfiles (≤1MB) are sent inline; large files are automatically encrypted\nand uploaded via the configured upload provider, then sent as a remote\nattachment.\n\nTo configure an upload provider for large files, add to your .env:\n\n  CONVOS_UPLOAD_PROVIDER=pinata\n  CONVOS_UPLOAD_PROVIDER_TOKEN=<your-pinata-jwt>\n  CONVOS_UPLOAD_PROVIDER_GATEWAY=https://your-gateway.mypinata.cloud\n\nOr pass --upload-provider and --upload-provider-token flags.\n\nThe MIME type is auto-detected from the file extension, or can be\nspecified manually with --mime-type.\n\nUse --encrypt to only encrypt the file and output decryption keys\nwithout sending (for manual upload workflows).",
+      "description": "Get detailed information about a conversation.\n\nResolves the per-conversation identity and shows full details\nincluding members, permissions, metadata, and identity info.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> ./photo.jpg",
-          "description": "Send a photo (auto-detects inline vs remote)"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> ./photo.jpg --remote",
-          "description": "Force remote upload even for small files"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> ./photo.jpg --encrypt",
-          "description": "Encrypt and output decryption keys (for manual upload)"
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id>",
+          "description": "Get conversation details"
         }
       ],
       "flags": {
@@ -2419,66 +2549,11 @@
           "helpValue": "<version>",
           "multiple": false,
           "type": "option"
-        },
-        "mime-type": {
-          "description": "Override the auto-detected MIME type",
-          "name": "mime-type",
-          "hasDynamicHelp": false,
-          "helpValue": "<type>",
-          "multiple": false,
-          "type": "option"
-        },
-        "encrypt": {
-          "description": "Encrypt the attachment and output decryption keys instead of sending. Upload the payload yourself, then use 'send-remote-attachment' to send.",
-          "name": "encrypt",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "encrypted-output": {
-          "dependsOn": [
-            "encrypt"
-          ],
-          "description": "When using --encrypt, write encrypted payload to this path (default: <file>.encrypted)",
-          "name": "encrypted-output",
-          "hasDynamicHelp": false,
-          "helpValue": "<path>",
-          "multiple": false,
-          "type": "option"
-        },
-        "upload-provider": {
-          "description": "Upload provider for remote attachments",
-          "name": "upload-provider",
-          "hasDynamicHelp": false,
-          "helpValue": "<provider>",
-          "multiple": false,
-          "type": "option"
-        },
-        "upload-provider-token": {
-          "description": "Authentication token for the upload provider",
-          "name": "upload-provider-token",
-          "hasDynamicHelp": false,
-          "helpValue": "<token>",
-          "multiple": false,
-          "type": "option"
-        },
-        "upload-provider-gateway": {
-          "description": "Custom gateway URL for the upload provider",
-          "name": "upload-provider-gateway",
-          "hasDynamicHelp": false,
-          "helpValue": "<url>",
-          "multiple": false,
-          "type": "option"
-        },
-        "remote": {
-          "description": "Force sending as a remote attachment (encrypt + upload), even for small files",
-          "name": "remote",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:send-attachment",
+      "id": "conversation:info",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -2527,186 +2602,35 @@
         "dist",
         "commands",
         "conversation",
-        "send-attachment.js"
+        "info.js"
       ]
     },
-    "conversation:send-reaction": {
+    "conversation:invite": {
       "aliases": [],
       "args": {
         "id": {
           "description": "The conversation ID",
           "name": "id",
           "required": true
-        },
-        "message-id": {
-          "description": "The message ID",
-          "name": "message-id",
-          "required": true
-        },
-        "action": {
-          "description": "add or remove",
-          "name": "action",
-          "options": [
-            "add",
-            "remove"
-          ],
-          "required": true
-        },
-        "emoji": {
-          "description": "The reaction emoji",
-          "name": "emoji",
-          "required": true
         }
       },
-      "description": "Send a reaction to a message.",
-      "flags": {
-        "env-file": {
-          "description": "Path to .env file",
-          "name": "env-file",
-          "hasDynamicHelp": false,
-          "helpValue": "<path>",
-          "multiple": false,
-          "type": "option"
-        },
-        "env": {
-          "description": "XMTP environment",
-          "name": "env",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "local",
-            "dev",
-            "production"
-          ],
-          "type": "option"
-        },
-        "gateway-host": {
-          "description": "Custom gateway URL",
-          "name": "gateway-host",
-          "hasDynamicHelp": false,
-          "helpValue": "<url>",
-          "multiple": false,
-          "type": "option"
-        },
-        "json": {
-          "description": "Format output as JSON",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "verbose": {
-          "description": "Show additional diagnostic information",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "log-level": {
-          "description": "Logging level",
-          "name": "log-level",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "off",
-            "error",
-            "warn",
-            "info",
-            "debug",
-            "trace"
-          ],
-          "type": "option"
-        },
-        "structured-logging": {
-          "description": "Enable structured JSON logging",
-          "name": "structured-logging",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "app-version": {
-          "description": "App version string",
-          "name": "app-version",
-          "hasDynamicHelp": false,
-          "helpValue": "<version>",
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "conversation:send-reaction",
-      "pluginAlias": "@xmtp/convos-cli",
-      "pluginName": "@xmtp/convos-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "commonFlags": {
-        "env-file": {
-          "description": "Path to .env file",
-          "helpValue": "<path>",
-          "input": [],
-          "multiple": false,
-          "type": "option"
-        },
-        "env": {
-          "options": [
-            "local",
-            "dev",
-            "production"
-          ],
-          "description": "XMTP environment",
-          "input": [],
-          "multiple": false,
-          "type": "option"
-        },
-        "gateway-host": {
-          "description": "Custom gateway URL",
-          "helpValue": "<url>",
-          "input": [],
-          "multiple": false,
-          "type": "option"
-        },
-        "json": {
-          "description": "Format output as JSON",
-          "allowNo": false,
-          "type": "boolean"
+      "description": "Generate an invite link for a conversation.\n\nCreates a cryptographic invite slug that others can use to request\nto join this conversation (per ADR 001).\n\nThe invite contains:\n- An encrypted conversation ID (only the creator can decrypt)\n- The creator's inbox ID (for routing the join request DM)\n- An invite tag (for verification and revocation)\n- Optional metadata (name, description)\n- A secp256k1 ECDSA signature\n\nDisplays a QR code in the terminal that can be scanned by the\nConvos app. The QR code encodes the full invite URL.\n\nInvite URLs use the format:\n- Dev:        dev.convos.org/v2?i=<slug>\n- Production: popup.convos.org/v2?i=<slug>",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id>",
+          "description": "Generate an invite with QR code (default)"
         },
-        "verbose": {
-          "description": "Show additional diagnostic information",
-          "default": false,
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "conversation",
-        "send-reaction.js"
-      ]
-    },
-    "conversation:send-remote-attachment": {
-      "aliases": [],
-      "args": {
-        "id": {
-          "description": "The conversation ID",
-          "name": "id",
-          "required": true
+        {
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --no-qr",
+          "description": "Generate an invite without QR code"
         },
-        "url": {
-          "description": "URL where the encrypted file is hosted",
-          "name": "url",
-          "required": true
-        }
-      },
-      "description": "Send a remote attachment message to a conversation.\n\nSends a reference to an encrypted file that has been uploaded to a URL.\nThe recipient downloads and decrypts the file using the provided keys.\n\nUse 'conversation send-attachment --encrypt' to encrypt a file and get\nthe required keys, then upload the encrypted payload and use this\ncommand to send the message.",
-      "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> https://example.com/file.enc --content-digest abc123 --secret <base64> --salt <base64> --nonce <base64> --content-length 12345",
-          "description": "Send a remote attachment"
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --expires-in 3600",
+          "description": "Generate an invite that expires in 1 hour"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> https://example.com/photo.enc --content-digest abc123 --secret <base64> --salt <base64> --nonce <base64> --content-length 12345 --filename photo.jpg",
-          "description": "Send with original filename"
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --single-use --json",
+          "description": "Generate a single-use invite with JSON output"
         }
       ],
       "flags": {
@@ -2779,65 +2703,36 @@
           "multiple": false,
           "type": "option"
         },
-        "content-digest": {
-          "description": "SHA-256 digest of the encrypted payload (hex)",
-          "name": "content-digest",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "secret": {
-          "description": "Decryption secret key (base64)",
-          "name": "secret",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "salt": {
-          "description": "Encryption salt (base64)",
-          "name": "salt",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "nonce": {
-          "description": "Encryption nonce (base64)",
-          "name": "nonce",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "qr": {
+          "description": "Display a QR code in the terminal",
+          "name": "qr",
+          "allowNo": true,
+          "type": "boolean"
         },
-        "scheme": {
-          "description": "URL scheme",
-          "name": "scheme",
-          "default": "https",
+        "expires-in": {
+          "description": "Invite expires in N seconds from now",
+          "name": "expires-in",
           "hasDynamicHelp": false,
+          "helpValue": "<seconds>",
           "multiple": false,
           "type": "option"
         },
-        "content-length": {
-          "description": "Size of the encrypted payload in bytes",
-          "name": "content-length",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "single-use": {
+          "description": "Invite expires after first use",
+          "name": "single-use",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "filename": {
-          "description": "Original filename",
-          "name": "filename",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "include-metadata": {
+          "description": "Include conversation name/description in invite",
+          "name": "include-metadata",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:send-remote-attachment",
+      "id": "conversation:invite",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -2886,36 +2781,27 @@
         "dist",
         "commands",
         "conversation",
-        "send-remote-attachment.js"
+        "invite.js"
       ]
     },
-    "conversation:send-reply": {
+    "conversation:lock": {
       "aliases": [],
       "args": {
         "id": {
           "description": "The conversation ID",
           "name": "id",
           "required": true
-        },
-        "message-id": {
-          "description": "The message ID to reply to",
-          "name": "message-id",
-          "required": true
-        },
-        "text": {
-          "description": "The reply text",
-          "name": "text"
         }
       },
-      "description": "Send a reply to a message.\n\nBy default, sends a text reply. Use --file to reply with a file\nattachment instead. Small files (≤1MB) are sent inline; large files\nare automatically encrypted and uploaded via the configured upload\nprovider, then sent as a remote attachment.",
+      "description": "Lock or unlock a conversation.\n\nLocking prevents new members from joining (per ADR 006) by:\n1. Rotating the invite tag (cryptographically invalidates all existing invites)\n2. Setting the XMTP addMember permission to 'deny'\n\nUnlocking restores the ability to add members. Previously shared\ninvites remain invalid — generate new ones after unlocking.\n\nOnly super admins can lock/unlock.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> <message-id> \"Reply text\"",
-          "description": "Reply with text"
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id>",
+          "description": "Lock a conversation"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> <message-id> --file ./photo.jpg",
-          "description": "Reply with a photo"
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --unlock",
+          "description": "Unlock a conversation"
         }
       ],
       "flags": {
@@ -2988,57 +2874,23 @@
           "multiple": false,
           "type": "option"
         },
-        "file": {
-          "char": "f",
-          "description": "Path to a file to send as the reply (instead of text)",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "helpValue": "<path>",
-          "multiple": false,
-          "type": "option"
-        },
-        "mime-type": {
-          "description": "Override the auto-detected MIME type (with --file)",
-          "name": "mime-type",
-          "hasDynamicHelp": false,
-          "helpValue": "<type>",
-          "multiple": false,
-          "type": "option"
-        },
-        "remote": {
-          "description": "Force sending file as a remote attachment, even for small files",
-          "name": "remote",
+        "unlock": {
+          "description": "Unlock instead of locking",
+          "name": "unlock",
           "allowNo": false,
           "type": "boolean"
         },
-        "upload-provider": {
-          "description": "Upload provider for remote attachments",
-          "name": "upload-provider",
-          "hasDynamicHelp": false,
-          "helpValue": "<provider>",
-          "multiple": false,
-          "type": "option"
-        },
-        "upload-provider-token": {
-          "description": "Authentication token for the upload provider",
-          "name": "upload-provider-token",
-          "hasDynamicHelp": false,
-          "helpValue": "<token>",
-          "multiple": false,
-          "type": "option"
-        },
-        "upload-provider-gateway": {
-          "description": "Custom gateway URL for the upload provider",
-          "name": "upload-provider-gateway",
-          "hasDynamicHelp": false,
-          "helpValue": "<url>",
-          "multiple": false,
-          "type": "option"
+        "force": {
+          "char": "f",
+          "description": "Skip confirmation prompt",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:send-reply",
+      "id": "conversation:lock",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -3087,10 +2939,10 @@
         "dist",
         "commands",
         "conversation",
-        "send-reply.js"
+        "lock.js"
       ]
     },
-    "conversation:send-text": {
+    "conversation:members": {
       "aliases": [],
       "args": {
         "id": {
@@ -3099,15 +2951,11 @@
           "required": true
         }
       },
-      "description": "Send a text message to a conversation.\n\nAutomatically resolves the per-conversation identity and sends\nthe message using the correct XMTP client.\n\nThe text can be provided as a positional argument or via --text.\nUse --text to avoid shell quoting issues (e.g. smart quotes on macOS).",
+      "description": "List members of a conversation.\n\nShows all members with their inbox IDs, identifiers, and permission levels.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> \"Hello!\"",
-          "description": "Send a text message"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --text \"Hello!\"",
-          "description": "Send using --text flag (avoids shell quoting issues)"
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id>",
+          "description": "List members"
         }
       ],
       "flags": {
@@ -3179,24 +3027,15 @@
           "helpValue": "<version>",
           "multiple": false,
           "type": "option"
-        },
-        "text": {
-          "char": "t",
-          "description": "The text message to send",
-          "name": "text",
-          "hasDynamicHelp": false,
-          "helpValue": "<message>",
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:send-text",
+      "id": "conversation:members",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "enableJsonFlag": false,
       "commonFlags": {
         "env-file": {
@@ -3241,10 +3080,10 @@
         "dist",
         "commands",
         "conversation",
-        "send-text.js"
+        "members.js"
       ]
     },
-    "conversation:stream": {
+    "conversation:messages": {
       "aliases": [],
       "args": {
         "id": {
@@ -3253,15 +3092,15 @@
           "required": true
         }
       },
-      "description": "Stream messages in a conversation.\n\nListens for new messages in real-time using the per-conversation identity.\n\nThe stream continues until timeout, count limit, or Ctrl+C.",
+      "description": "List messages in a conversation.\n\nRetrieves messages using the per-conversation identity.\nSupports filtering, pagination, and sorting.",
       "examples": [
         {
           "command": "<%= config.bin %> <%= command.id %> <conversation-id>",
-          "description": "Stream messages indefinitely"
+          "description": "List messages"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --timeout 60",
-          "description": "Stream for 60 seconds"
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --sync --limit 10",
+          "description": "Sync and show last 10 messages"
         }
       ],
       "flags": {
@@ -3334,26 +3173,125 @@
           "multiple": false,
           "type": "option"
         },
-        "timeout": {
-          "description": "Stop streaming after N seconds",
-          "name": "timeout",
+        "sync": {
+          "description": "Sync from network before listing",
+          "name": "sync",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Maximum number of messages",
+          "name": "limit",
           "hasDynamicHelp": false,
-          "helpValue": "<seconds>",
+          "helpValue": "<number>",
           "multiple": false,
           "type": "option"
         },
-        "count": {
-          "description": "Stop after receiving N messages",
-          "name": "count",
+        "direction": {
+          "description": "Sort direction",
+          "name": "direction",
+          "default": "descending",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "ascending",
+            "descending"
+          ],
+          "type": "option"
+        },
+        "sent-before": {
+          "description": "Only messages sent before this timestamp (nanoseconds)",
+          "name": "sent-before",
+          "hasDynamicHelp": false,
+          "helpValue": "<ns>",
+          "multiple": false,
+          "type": "option"
+        },
+        "sent-after": {
+          "description": "Only messages sent after this timestamp (nanoseconds)",
+          "name": "sent-after",
+          "hasDynamicHelp": false,
+          "helpValue": "<ns>",
+          "multiple": false,
+          "type": "option"
+        },
+        "delivery-status": {
+          "description": "Filter by delivery status",
+          "name": "delivery-status",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "unpublished",
+            "published",
+            "failed"
+          ],
+          "type": "option"
+        },
+        "kind": {
+          "description": "Filter by message kind",
+          "name": "kind",
           "hasDynamicHelp": false,
-          "helpValue": "<number>",
           "multiple": false,
+          "options": [
+            "application",
+            "membership-change"
+          ],
+          "type": "option"
+        },
+        "content-type": {
+          "description": "Filter by content type (repeatable)",
+          "name": "content-type",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "actions",
+            "attachment",
+            "custom",
+            "group-membership-change",
+            "group-updated",
+            "intent",
+            "leave-request",
+            "markdown",
+            "multi-remote-attachment",
+            "reaction",
+            "read-receipt",
+            "remote-attachment",
+            "reply",
+            "text",
+            "transaction-reference",
+            "wallet-send-calls"
+          ],
+          "type": "option"
+        },
+        "exclude-content-type": {
+          "description": "Exclude content type (repeatable)",
+          "name": "exclude-content-type",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "actions",
+            "attachment",
+            "custom",
+            "group-membership-change",
+            "group-updated",
+            "intent",
+            "leave-request",
+            "markdown",
+            "multi-remote-attachment",
+            "reaction",
+            "read-receipt",
+            "remote-attachment",
+            "reply",
+            "text",
+            "transaction-reference",
+            "wallet-send-calls"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:stream",
+      "id": "conversation:messages",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -3402,10 +3340,10 @@
         "dist",
         "commands",
         "conversation",
-        "stream.js"
+        "messages.js"
       ]
     },
-    "conversation:sync": {
+    "conversation:permissions": {
       "aliases": [],
       "args": {
         "id": {
@@ -3414,7 +3352,7 @@
           "required": true
         }
       },
-      "description": "Sync a specific conversation from the network.",
+      "description": "View permissions for a conversation.",
       "flags": {
         "env-file": {
           "description": "Path to .env file",
@@ -3488,7 +3426,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:sync",
+      "id": "conversation:permissions",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -3537,29 +3475,29 @@
         "dist",
         "commands",
         "conversation",
-        "sync.js"
+        "permissions.js"
       ]
     },
-    "conversation:update-consent": {
-      "aliases": [],
-      "args": {
-        "id": {
-          "description": "The conversation ID",
-          "name": "id",
-          "required": true
-        },
-        "state": {
-          "description": "The new consent state",
-          "name": "state",
-          "options": [
-            "allowed",
-            "denied",
-            "unknown"
-          ],
+    "conversation:profiles": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "The conversation ID",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Update the consent state of a conversation.",
+      "description": "List member profiles in a conversation.\n\nShows display names and avatar URLs for all members who have set\na profile in this conversation. Profiles are stored in the group's\nmetadata and are visible to all members (ADR 005).\n\nMembers without a profile appear as anonymous with just their inbox ID.",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id>",
+          "description": "List all member profiles"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --json",
+          "description": "List profiles as JSON"
+        }
+      ],
       "flags": {
         "env-file": {
           "description": "Path to .env file",
@@ -3633,7 +3571,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:update-consent",
+      "id": "conversation:profiles",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -3682,24 +3620,19 @@
         "dist",
         "commands",
         "conversation",
-        "update-consent.js"
+        "profiles.js"
       ]
     },
-    "conversation:update-description": {
+    "conversation:remove-members": {
       "aliases": [],
       "args": {
         "id": {
           "description": "The conversation ID",
           "name": "id",
           "required": true
-        },
-        "description": {
-          "description": "The new description",
-          "name": "description",
-          "required": true
         }
       },
-      "description": "Update the description of a conversation.",
+      "description": "Remove members from a conversation. Requires super admin permissions.",
       "flags": {
         "env-file": {
           "description": "Path to .env file",
@@ -3773,11 +3706,11 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:update-description",
+      "id": "conversation:remove-members",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
       "enableJsonFlag": false,
       "commonFlags": {
         "env-file": {
@@ -3822,10 +3755,10 @@
         "dist",
         "commands",
         "conversation",
-        "update-description.js"
+        "remove-members.js"
       ]
     },
-    "conversation:update-name": {
+    "conversation:send-attachment": {
       "aliases": [],
       "args": {
         "id": {
@@ -3833,13 +3766,27 @@
           "name": "id",
           "required": true
         },
-        "name": {
-          "description": "The new name",
-          "name": "name",
+        "file": {
+          "description": "Path to the file to send",
+          "name": "file",
           "required": true
         }
       },
-      "description": "Update the name of a conversation. Visible to all members.",
+      "description": "Send a file attachment to a conversation.\n\nReads a file from disk and sends it as an attachment message. Small\nfiles (≤1MB) are sent inline; large files are automatically encrypted\nand uploaded via the configured upload provider, then sent as a remote\nattachment.\n\nTo configure an upload provider for large files, add to your .env:\n\n  CONVOS_UPLOAD_PROVIDER=pinata\n  CONVOS_UPLOAD_PROVIDER_TOKEN=<your-pinata-jwt>\n  CONVOS_UPLOAD_PROVIDER_GATEWAY=https://your-gateway.mypinata.cloud\n\nOr pass --upload-provider and --upload-provider-token flags.\n\nThe MIME type is auto-detected from the file extension, or can be\nspecified manually with --mime-type.\n\nUse --encrypt to only encrypt the file and output decryption keys\nwithout sending (for manual upload workflows).",
+      "examples": [
+        {
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> ./photo.jpg",
+          "description": "Send a photo (auto-detects inline vs remote)"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> ./photo.jpg --remote",
+          "description": "Force remote upload even for small files"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> ./photo.jpg --encrypt",
+          "description": "Encrypt and output decryption keys (for manual upload)"
+        }
+      ],
       "flags": {
         "env-file": {
           "description": "Path to .env file",
@@ -3909,11 +3856,66 @@
           "helpValue": "<version>",
           "multiple": false,
           "type": "option"
+        },
+        "mime-type": {
+          "description": "Override the auto-detected MIME type",
+          "name": "mime-type",
+          "hasDynamicHelp": false,
+          "helpValue": "<type>",
+          "multiple": false,
+          "type": "option"
+        },
+        "encrypt": {
+          "description": "Encrypt the attachment and output decryption keys instead of sending. Upload the payload yourself, then use 'send-remote-attachment' to send.",
+          "name": "encrypt",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "encrypted-output": {
+          "dependsOn": [
+            "encrypt"
+          ],
+          "description": "When using --encrypt, write encrypted payload to this path (default: <file>.encrypted)",
+          "name": "encrypted-output",
+          "hasDynamicHelp": false,
+          "helpValue": "<path>",
+          "multiple": false,
+          "type": "option"
+        },
+        "upload-provider": {
+          "description": "Upload provider for remote attachments",
+          "name": "upload-provider",
+          "hasDynamicHelp": false,
+          "helpValue": "<provider>",
+          "multiple": false,
+          "type": "option"
+        },
+        "upload-provider-token": {
+          "description": "Authentication token for the upload provider",
+          "name": "upload-provider-token",
+          "hasDynamicHelp": false,
+          "helpValue": "<token>",
+          "multiple": false,
+          "type": "option"
+        },
+        "upload-provider-gateway": {
+          "description": "Custom gateway URL for the upload provider",
+          "name": "upload-provider-gateway",
+          "hasDynamicHelp": false,
+          "helpValue": "<url>",
+          "multiple": false,
+          "type": "option"
+        },
+        "remote": {
+          "description": "Force sending as a remote attachment (encrypt + upload), even for small files",
+          "name": "remote",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:update-name",
+      "id": "conversation:send-attachment",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -3962,33 +3964,38 @@
         "dist",
         "commands",
         "conversation",
-        "update-name.js"
+        "send-attachment.js"
       ]
     },
-    "conversation:update-profile": {
+    "conversation:send-reaction": {
       "aliases": [],
       "args": {
         "id": {
           "description": "The conversation ID",
           "name": "id",
           "required": true
-        }
-      },
-      "description": "Set your display name and avatar in a conversation.\n\nProfiles are stored in the group's metadata (appData) and visible\nto all members. Each conversation has independent profiles — you\ncan be a different person in each conversation (ADR 005).\n\nUpdates are synced to all members via XMTP's group metadata.\nThe profile is stored as a compressed protobuf in the group's\nappData field (max 8KB shared across all profiles and metadata).",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --name \"Alice\"",
-          "description": "Set your display name"
         },
-        {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --name \"Alice\" --image \"https://example.com/avatar.jpg\"",
-          "description": "Set display name and avatar"
+        "message-id": {
+          "description": "The message ID",
+          "name": "message-id",
+          "required": true
         },
-        {
-          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --name \"\" --image \"\"",
-          "description": "Clear your profile (go anonymous)"
+        "action": {
+          "description": "add or remove",
+          "name": "action",
+          "options": [
+            "add",
+            "remove"
+          ],
+          "required": true
+        },
+        "emoji": {
+          "description": "The reaction emoji",
+          "name": "emoji",
+          "required": true
         }
-      ],
+      },
+      "description": "Send a reaction to a message.",
       "flags": {
         "env-file": {
           "description": "Path to .env file",
@@ -4058,27 +4065,11 @@
           "helpValue": "<version>",
           "multiple": false,
           "type": "option"
-        },
-        "name": {
-          "description": "Display name (empty string to clear)",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "helpValue": "<name>",
-          "multiple": false,
-          "type": "option"
-        },
-        "image": {
-          "description": "Avatar image URL (empty string to clear)",
-          "name": "image",
-          "hasDynamicHelp": false,
-          "helpValue": "<url>",
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversation:update-profile",
+      "id": "conversation:send-reaction",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -4127,25 +4118,32 @@
         "dist",
         "commands",
         "conversation",
-        "update-profile.js"
+        "send-reaction.js"
       ]
     },
-    "identity:create": {
+    "conversation:send-remote-attachment": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new Convos identity.\n\nGenerates a new wallet key and database encryption key for use with\na single conversation. Each conversation gets its own identity for\nmaximum privacy (per ADR 002).\n\nYou can optionally set a label (local-only) and profile name (shared\nwith conversation members per ADR 005).",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %>",
-          "description": "Create a new identity"
+      "args": {
+        "id": {
+          "description": "The conversation ID",
+          "name": "id",
+          "required": true
         },
+        "url": {
+          "description": "URL where the encrypted file is hosted",
+          "name": "url",
+          "required": true
+        }
+      },
+      "description": "Send a remote attachment message to a conversation.\n\nSends a reference to an encrypted file that has been uploaded to a URL.\nThe recipient downloads and decrypts the file using the provided keys.\n\nUse 'conversation send-attachment --encrypt' to encrypt a file and get\nthe required keys, then upload the encrypted payload and use this\ncommand to send the message.",
+      "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> --label \"Work Chat\"",
-          "description": "Create with a local label"
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> https://example.com/file.enc --content-digest abc123 --secret <base64> --salt <base64> --nonce <base64> --content-length 12345",
+          "description": "Send a remote attachment"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --label \"Team\" --profile-name \"Alice\"",
-          "description": "Create with label and profile name"
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> https://example.com/photo.enc --content-digest abc123 --secret <base64> --salt <base64> --nonce <base64> --content-length 12345 --filename photo.jpg",
+          "description": "Send with original filename"
         }
       ],
       "flags": {
@@ -4218,26 +4216,65 @@
           "multiple": false,
           "type": "option"
         },
-        "label": {
-          "description": "Local label for this identity (not shared)",
-          "name": "label",
+        "content-digest": {
+          "description": "SHA-256 digest of the encrypted payload (hex)",
+          "name": "content-digest",
+          "required": true,
           "hasDynamicHelp": false,
-          "helpValue": "<label>",
           "multiple": false,
           "type": "option"
         },
-        "profile-name": {
-          "description": "Profile display name (shared with conversation members)",
-          "name": "profile-name",
+        "secret": {
+          "description": "Decryption secret key (base64)",
+          "name": "secret",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "salt": {
+          "description": "Encryption salt (base64)",
+          "name": "salt",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "nonce": {
+          "description": "Encryption nonce (base64)",
+          "name": "nonce",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "scheme": {
+          "description": "URL scheme",
+          "name": "scheme",
+          "default": "https",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "content-length": {
+          "description": "Size of the encrypted payload in bytes",
+          "name": "content-length",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "filename": {
+          "description": "Original filename",
+          "name": "filename",
           "hasDynamicHelp": false,
-          "helpValue": "<name>",
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "identity:create",
+      "id": "conversation:send-remote-attachment",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -4285,24 +4322,37 @@
       "relativePath": [
         "dist",
         "commands",
-        "identity",
-        "create.js"
+        "conversation",
+        "send-remote-attachment.js"
       ]
     },
-    "identity:info": {
+    "conversation:send-reply": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "The identity ID",
+          "description": "The conversation ID",
           "name": "id",
           "required": true
+        },
+        "message-id": {
+          "description": "The message ID to reply to",
+          "name": "message-id",
+          "required": true
+        },
+        "text": {
+          "description": "The reply text",
+          "name": "text"
         }
       },
-      "description": "Display detailed information about an identity.\n\nShows wallet address, XMTP inbox ID, linked conversation, profile\nsettings, and XMTP client details. Creates and registers the XMTP\nclient if not yet registered.",
+      "description": "Send a reply to a message.\n\nBy default, sends a text reply. Use --file to reply with a file\nattachment instead. Small files (≤1MB) are sent inline; large files\nare automatically encrypted and uploaded via the configured upload\nprovider, then sent as a remote attachment.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> <identity-id>",
-          "description": "Show identity details"
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> <message-id> \"Reply text\"",
+          "description": "Reply with text"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> <message-id> --file ./photo.jpg",
+          "description": "Reply with a photo"
         }
       ],
       "flags": {
@@ -4374,11 +4424,58 @@
           "helpValue": "<version>",
           "multiple": false,
           "type": "option"
+        },
+        "file": {
+          "char": "f",
+          "description": "Path to a file to send as the reply (instead of text)",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "helpValue": "<path>",
+          "multiple": false,
+          "type": "option"
+        },
+        "mime-type": {
+          "description": "Override the auto-detected MIME type (with --file)",
+          "name": "mime-type",
+          "hasDynamicHelp": false,
+          "helpValue": "<type>",
+          "multiple": false,
+          "type": "option"
+        },
+        "remote": {
+          "description": "Force sending file as a remote attachment, even for small files",
+          "name": "remote",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "upload-provider": {
+          "description": "Upload provider for remote attachments",
+          "name": "upload-provider",
+          "hasDynamicHelp": false,
+          "helpValue": "<provider>",
+          "multiple": false,
+          "type": "option"
+        },
+        "upload-provider-token": {
+          "description": "Authentication token for the upload provider",
+          "name": "upload-provider-token",
+          "hasDynamicHelp": false,
+          "helpValue": "<token>",
+          "multiple": false,
+          "type": "option"
+        },
+        "upload-provider-gateway": {
+          "description": "Custom gateway URL for the upload provider",
+          "name": "upload-provider-gateway",
+          "hasDynamicHelp": false,
+          "helpValue": "<url>",
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "identity:info",
+      "id": "conversation:send-reply",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -4426,22 +4523,28 @@
       "relativePath": [
         "dist",
         "commands",
-        "identity",
-        "info.js"
+        "conversation",
+        "send-reply.js"
       ]
     },
-    "identity:list": {
+    "conversation:send-text": {
       "aliases": [],
-      "args": {},
-      "description": "List all Convos identities.\n\nEach Convos conversation uses its own XMTP identity (inbox) for privacy.\nThis command shows all identities, including which conversation each is\nlinked to.\n\nIdentities without a conversation ID are \"unlinked\" — available for\nuse with new conversations.",
+      "args": {
+        "id": {
+          "description": "The conversation ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Send a text message to a conversation.\n\nAutomatically resolves the per-conversation identity and sends\nthe message using the correct XMTP client.\n\nThe text can be provided as a positional argument or via --text.\nUse --text to avoid shell quoting issues (e.g. smart quotes on macOS).",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %>",
-          "description": "List all identities"
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> \"Hello!\"",
+          "description": "Send a text message"
         },
         {
-          "command": "<%= config.bin %> <%= command.id %> --json",
-          "description": "Output as JSON"
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --text \"Hello!\"",
+          "description": "Send using --text flag (avoids shell quoting issues)"
         }
       ],
       "flags": {
@@ -4513,15 +4616,24 @@
           "helpValue": "<version>",
           "multiple": false,
           "type": "option"
+        },
+        "text": {
+          "char": "t",
+          "description": "The text message to send",
+          "name": "text",
+          "hasDynamicHelp": false,
+          "helpValue": "<message>",
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "identity:list",
+      "id": "conversation:send-text",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
       "enableJsonFlag": false,
       "commonFlags": {
         "env-file": {
@@ -4565,24 +4677,28 @@
       "relativePath": [
         "dist",
         "commands",
-        "identity",
-        "list.js"
+        "conversation",
+        "send-text.js"
       ]
     },
-    "identity:remove": {
+    "conversation:stream": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "The identity ID to remove",
+          "description": "The conversation ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Remove an identity and all associated data.\n\nPermanently deletes the identity's wallet key, database encryption key,\nXMTP database files, and all local data. This is irreversible.\n\nPer ADR 002 and ADR 004: destroying an identity destroys the\ncryptographic material needed to participate in its conversation.",
+      "description": "Stream messages in a conversation.\n\nListens for new messages in real-time using the per-conversation identity.\n\nThe stream continues until timeout, count limit, or Ctrl+C.",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %> <identity-id> --force",
-          "description": "Remove an identity"
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id>",
+          "description": "Stream messages indefinitely"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --timeout 60",
+          "description": "Stream for 60 seconds"
         }
       ],
       "flags": {
@@ -4655,17 +4771,26 @@
           "multiple": false,
           "type": "option"
         },
-        "force": {
-          "char": "f",
-          "description": "Skip confirmation prompt",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
+        "timeout": {
+          "description": "Stop streaming after N seconds",
+          "name": "timeout",
+          "hasDynamicHelp": false,
+          "helpValue": "<seconds>",
+          "multiple": false,
+          "type": "option"
+        },
+        "count": {
+          "description": "Stop after receiving N messages",
+          "name": "count",
+          "hasDynamicHelp": false,
+          "helpValue": "<number>",
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "identity:remove",
+      "id": "conversation:stream",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -4713,32 +4838,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "identity",
-        "remove.js"
+        "conversation",
+        "stream.js"
       ]
     },
-    "conversations:create": {
+    "conversation:sync": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new Convos conversation.\n\nCreates a new conversation with a fresh per-conversation identity.\nEach conversation gets its own XMTP inbox for privacy isolation\n(per ADR 002).\n\nThis command:\n1. Creates a new identity (or uses an existing unlinked one)\n2. Initializes the XMTP client for that identity\n3. Creates a group conversation\n4. Links the identity to the conversation\n\nThe creator becomes super admin. Others join via invite links.",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %> --name \"Project Team\"",
-          "description": "Create a named conversation"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --name \"Team\" --description \"Team discussion\"",
-          "description": "Create with metadata"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --identity <identity-id>",
-          "description": "Use a pre-created identity"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --name \"Private\" --permissions admin-only --json",
-          "description": "Create admin-only group with JSON output"
+      "args": {
+        "id": {
+          "description": "The conversation ID",
+          "name": "id",
+          "required": true
         }
-      ],
+      },
+      "description": "Sync a specific conversation from the network.",
       "flags": {
         "env-file": {
           "description": "Path to .env file",
@@ -4780,99 +4893,39 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "log-level": {
-          "description": "Logging level",
-          "name": "log-level",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "off",
-            "error",
-            "warn",
-            "info",
-            "debug",
-            "trace"
-          ],
-          "type": "option"
-        },
-        "structured-logging": {
-          "description": "Enable structured JSON logging",
-          "name": "structured-logging",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "app-version": {
-          "description": "App version string",
-          "name": "app-version",
-          "hasDynamicHelp": false,
-          "helpValue": "<version>",
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "description": "Conversation name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "helpValue": "<name>",
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "description": "Conversation description",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "helpValue": "<description>",
-          "multiple": false,
-          "type": "option"
-        },
-        "image-url": {
-          "description": "Conversation image URL",
-          "name": "image-url",
-          "hasDynamicHelp": false,
-          "helpValue": "<url>",
-          "multiple": false,
-          "type": "option"
-        },
-        "permissions": {
-          "description": "Permission preset",
-          "name": "permissions",
-          "default": "all-members",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "all-members",
-            "admin-only"
-          ],
-          "type": "option"
-        },
-        "identity": {
-          "description": "Use an existing unlinked identity ID",
-          "name": "identity",
+        "log-level": {
+          "description": "Logging level",
+          "name": "log-level",
           "hasDynamicHelp": false,
-          "helpValue": "<id>",
           "multiple": false,
+          "options": [
+            "off",
+            "error",
+            "warn",
+            "info",
+            "debug",
+            "trace"
+          ],
           "type": "option"
         },
-        "label": {
-          "description": "Local label for the identity",
-          "name": "label",
-          "hasDynamicHelp": false,
-          "helpValue": "<label>",
-          "multiple": false,
-          "type": "option"
+        "structured-logging": {
+          "description": "Enable structured JSON logging",
+          "name": "structured-logging",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "profile-name": {
-          "description": "Profile display name for this conversation",
-          "name": "profile-name",
+        "app-version": {
+          "description": "App version string",
+          "name": "app-version",
           "hasDynamicHelp": false,
-          "helpValue": "<name>",
+          "helpValue": "<version>",
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversations:create",
+      "id": "conversation:sync",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -4920,38 +4973,30 @@
       "relativePath": [
         "dist",
         "commands",
-        "conversations",
-        "create.js"
+        "conversation",
+        "sync.js"
       ]
     },
-    "conversations:join": {
+    "conversation:update-consent": {
       "aliases": [],
       "args": {
-        "invite": {
-          "description": "Invite slug or URL",
-          "name": "invite",
+        "id": {
+          "description": "The conversation ID",
+          "name": "id",
           "required": true
-        }
-      },
-      "description": "Join a conversation using an invite slug or URL.\n\nImplements the Convos join flow (per ADR 001):\n\n1. Parse and validate the invite (verify signature, check expiration)\n2. Create a new per-conversation identity for this conversation\n3. Send the invite slug as a DM to the creator's inbox\n4. Wait for the creator's client to process the join request and\n   add this identity to the conversation\n5. Link the identity to the conversation once joined\n\nThe creator's client (iOS app or another CLI instance running\n'convos conversations process-join-requests') must be online to\nprocess the join request.\n\nAccepts either a raw invite slug or a full URL containing the\nslug as query parameter 'i'.",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %> <invite-slug>",
-          "description": "Join using a raw invite slug"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> \"https://popup.convos.org/v2?i=<slug>\"",
-          "description": "Join using a full invite URL"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> <slug> --no-wait",
-          "description": "Send join request without waiting for acceptance"
         },
-        {
-          "command": "<%= config.bin %> <%= command.id %> <slug> --timeout 120 --json",
-          "description": "Wait up to 2 minutes for acceptance"
+        "state": {
+          "description": "The new consent state",
+          "name": "state",
+          "options": [
+            "allowed",
+            "denied",
+            "unknown"
+          ],
+          "required": true
         }
-      ],
+      },
+      "description": "Update the consent state of a conversation.",
       "flags": {
         "env-file": {
           "description": "Path to .env file",
@@ -5021,50 +5066,11 @@
           "helpValue": "<version>",
           "multiple": false,
           "type": "option"
-        },
-        "no-wait": {
-          "description": "Send the join request but don't wait for the creator to accept",
-          "name": "no-wait",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "timeout": {
-          "description": "Seconds to wait for acceptance (default: 60)",
-          "name": "timeout",
-          "default": 60,
-          "hasDynamicHelp": false,
-          "helpValue": "<seconds>",
-          "multiple": false,
-          "type": "option"
-        },
-        "label": {
-          "description": "Local label for the new identity",
-          "name": "label",
-          "hasDynamicHelp": false,
-          "helpValue": "<label>",
-          "multiple": false,
-          "type": "option"
-        },
-        "profile-name": {
-          "description": "Profile display name for this conversation",
-          "name": "profile-name",
-          "hasDynamicHelp": false,
-          "helpValue": "<name>",
-          "multiple": false,
-          "type": "option"
-        },
-        "identity": {
-          "description": "Use an existing unlinked identity instead of creating one",
-          "name": "identity",
-          "hasDynamicHelp": false,
-          "helpValue": "<id>",
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversations:join",
+      "id": "conversation:update-consent",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -5112,28 +5118,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "conversations",
-        "join.js"
+        "conversation",
+        "update-consent.js"
       ]
     },
-    "conversations:list": {
+    "conversation:update-description": {
       "aliases": [],
-      "args": {},
-      "description": "List all Convos conversations.\n\nLists conversations across all per-conversation identities.\nEach conversation is associated with its own XMTP identity.\n\nUse --sync to fetch the latest state from the network.",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %>",
-          "description": "List all conversations"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --sync",
-          "description": "Sync from network then list"
+      "args": {
+        "id": {
+          "description": "The conversation ID",
+          "name": "id",
+          "required": true
         },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --json",
-          "description": "Output as JSON"
+        "description": {
+          "description": "The new description",
+          "name": "description",
+          "required": true
         }
-      ],
+      },
+      "description": "Update the description of a conversation.",
       "flags": {
         "env-file": {
           "description": "Path to .env file",
@@ -5203,17 +5206,11 @@
           "helpValue": "<version>",
           "multiple": false,
           "type": "option"
-        },
-        "sync": {
-          "description": "Sync each identity from network before listing",
-          "name": "sync",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversations:list",
+      "id": "conversation:update-description",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -5261,28 +5258,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "conversations",
-        "list.js"
+        "conversation",
+        "update-description.js"
       ]
     },
-    "conversations:process-join-requests": {
+    "conversation:update-name": {
       "aliases": [],
-      "args": {},
-      "description": "Process pending join requests for all conversations.\n\nScans DMs for each identity looking for join requests (text messages\ncontaining signed invite slugs). When a valid join request is found:\n\n1. Verify the invite signature\n2. Decrypt the conversation token to get the conversation ID\n3. Verify the creator inbox ID matches\n4. Add the requester to the conversation\n5. Block invalid/spam requests\n\nWithout --watch, processes all pending DMs and exits.\nWith --watch, streams DM messages in real-time and processes\njoin requests as they arrive (recommended for always-on usage).",
-      "examples": [
-        {
-          "command": "<%= config.bin %> <%= command.id %>",
-          "description": "Process all pending join requests"
-        },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --watch",
-          "description": "Continuously stream and process join requests in real-time"
+      "args": {
+        "id": {
+          "description": "The conversation ID",
+          "name": "id",
+          "required": true
         },
-        {
-          "command": "<%= config.bin %> <%= command.id %> --conversation <id>",
-          "description": "Process join requests for a specific conversation only"
+        "name": {
+          "description": "The new name",
+          "name": "name",
+          "required": true
         }
-      ],
+      },
+      "description": "Update the name of a conversation. Visible to all members.",
       "flags": {
         "env-file": {
           "description": "Path to .env file",
@@ -5352,25 +5346,11 @@
           "helpValue": "<version>",
           "multiple": false,
           "type": "option"
-        },
-        "watch": {
-          "description": "Stream DM messages in real-time and process join requests as they arrive",
-          "name": "watch",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "conversation": {
-          "description": "Only process requests for this conversation ID",
-          "name": "conversation",
-          "hasDynamicHelp": false,
-          "helpValue": "<id>",
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversations:process-join-requests",
+      "id": "conversation:update-name",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -5418,18 +5398,32 @@
       "relativePath": [
         "dist",
         "commands",
-        "conversations",
-        "process-join-requests.js"
+        "conversation",
+        "update-name.js"
       ]
     },
-    "conversations:sync": {
+    "conversation:update-profile": {
       "aliases": [],
-      "args": {},
-      "description": "Sync all conversations from the network.\n\nSynchronizes every linked identity with the XMTP network.\nFetches new messages and membership changes for all conversations.",
+      "args": {
+        "id": {
+          "description": "The conversation ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Set your display name and avatar in a conversation.\n\nProfiles are stored in the group's metadata (appData) and visible\nto all members. Each conversation has independent profiles — you\ncan be a different person in each conversation (ADR 005).\n\nUpdates are synced to all members via XMTP's group metadata.\nThe profile is stored as a compressed protobuf in the group's\nappData field (max 8KB shared across all profiles and metadata).",
       "examples": [
         {
-          "command": "<%= config.bin %> <%= command.id %>",
-          "description": "Sync all conversations"
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --name \"Alice\"",
+          "description": "Set your display name"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --name \"Alice\" --image \"https://example.com/avatar.jpg\"",
+          "description": "Set display name and avatar"
+        },
+        {
+          "command": "<%= config.bin %> <%= command.id %> <conversation-id> --name \"\" --image \"\"",
+          "description": "Clear your profile (go anonymous)"
         }
       ],
       "flags": {
@@ -5501,11 +5495,27 @@
           "helpValue": "<version>",
           "multiple": false,
           "type": "option"
+        },
+        "name": {
+          "description": "Display name (empty string to clear)",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "helpValue": "<name>",
+          "multiple": false,
+          "type": "option"
+        },
+        "image": {
+          "description": "Avatar image URL (empty string to clear)",
+          "name": "image",
+          "hasDynamicHelp": false,
+          "helpValue": "<url>",
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "conversations:sync",
+      "id": "conversation:update-profile",
       "pluginAlias": "@xmtp/convos-cli",
       "pluginName": "@xmtp/convos-cli",
       "pluginType": "core",
@@ -5553,10 +5563,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "conversations",
-        "sync.js"
+        "conversation",
+        "update-profile.js"
       ]
     }
   },
-  "version": "0.1.0"
+  "version": "0.2.0"
 }