xmtp-cli

⚠Review·Scanned 2/18/2026

This skill documents the XMTP CLI for testing and managing conversations, groups, and messages via xmtp and installation via npm/npx. It directs creating a .env containing XMTP_WALLET_KEY/XMTP_DB_ENCRYPTION_KEY, running shell commands (e.g. xmtp init), and configuring XMTP_GATEWAY_HOST (e.g. https://my-gateway.example.com).

from clawhub.ai·v1.0.0·18.3 KB·0 installs
Scanned from 1.0.0 at 22a2692 · Transparency log ↗
$ vett add clawhub.ai/humanagent/xmtp-cliReview findings below

XMTP CLI

Use the xmtp command to test, debug, and interact with XMTP conversations, groups, and messages from the command line. This skill is the entry point; use the sub-skills below for specific CLI tasks.

When to apply

  • Testing or debugging XMTP from the command line
  • Sending messages or creating and managing groups
  • Listing or finding conversations, members, and messages
  • Syncing conversations and messages
  • Managing group permissions
  • Demonstrating content types (text, markdown, attachment, transaction, deeplink, miniapp)

Sub-skills

Sub-skillUse when
setupInitialize CLI and configure env (init, env variables)
groupsCreate DM or group, update group metadata
sendSend messages to address or group
listList conversations, members, messages; find by address or inbox
debugGet info, resolve address, inspect inbox
syncSync conversations or sync all
permissionsList/info group permissions, update permissions
contentDemo text, markdown, attachment, transaction, deeplink, miniapp
debuggingEnable CLI debug logging (XMTP_FORCE_DEBUG env)

How to use

  1. Pick the sub-skill that matches the task (e.g. send message → send).
  2. Read that sub-skill’s SKILL.md and its rules/ for step-by-step guidance.

Install

npm install -g @xmtp/cli
# or
pnpm add -g @xmtp/cli
# or
yarn global add @xmtp/cli

Run without install

npx @xmtp/cli <command> <arguments>
# or pnpx / yarn dlx

Help

xmtp --help
xmtp <command> --help

Full documentation: docs.xmtp.org