How do I install the Xmtp CLI skill?

Run npx skillmds@latest add dvcrn/xmtp-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Xmtp CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Xmtp CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Xmtp CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Xmtp CLI?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Xmtp CLI by dvcrn — Agent Skill

Name: Xmtp CLI
Rating: 4.2 (5 reviews)
Author: dvcrn

Xmtp CLI

Run and script the XMTP CLI for testing, debugging, and interacting with XMTP conversations, groups, and messages. Use when the user needs init, send, list, groups, debug, sync, permissions, or content commands from the CLI.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

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-skill	Use when
setup	Initialize CLI and configure env (init, env variables)
groups	Create DM or group, update group metadata
send	Send messages to address or group
list	List conversations, members, messages; find by address or inbox
debug	Get info, resolve address, inspect inbox
sync	Sync conversations or sync all
permissions	List/info group permissions, update permissions
content	Demo text, markdown, attachment, transaction, deeplink, miniapp
debugging	Enable CLI debug logging (XMTP_FORCE_DEBUG env)

How to use

Pick the sub-skill that matches the task (e.g. send message → send).
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

---name: xmtp-clidescription: Run and script the XMTP CLI for testing, debugging, and interacting with XMTP conversations, groups, and messages. Use when the user needs init, send, list, groups, debug, sync, permissions, or content commands from the CLI.---# XMTP CLIUse 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-skill | Use when ||-----------|----------|| **setup** | Initialize CLI and configure env (init, env variables) || **groups** | Create DM or group, update group metadata || **send** | Send messages to address or group || **list** | List conversations, members, messages; find by address or inbox || **debug** | Get info, resolve address, inspect inbox || **sync** | Sync conversations or sync all || **permissions** | List/info group permissions, update permissions || **content** | Demo text, markdown, attachment, transaction, deeplink, miniapp || **debugging** | Enable CLI debug logging (XMTP_FORCE_DEBUG env) |## How to use1. 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```bashnpm install -g @xmtp/cli# orpnpm add -g @xmtp/cli# oryarn global add @xmtp/cli```## Run without install```bashnpx @xmtp/cli <command> <arguments># or pnpx / yarn dlx```## Help```bashxmtp --helpxmtp <command> --help```Full documentation: [docs.xmtp.org](https://docs.xmtp.org)

Frequently asked questions