# Xmtp CLI Debugging

> Enable CLI debug logging with environment variables. Use when troubleshooting or inspecting CLI behavior.

- Skill: `modbender/xmtp-cli-debugging` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add modbender/xmtp-cli-debugging`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/xmtp-cli-debugging/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/xmtp-cli-debugging

---


# CLI debugging

Enable debug logging for the XMTP CLI via environment variables.

## When to apply

- Troubleshooting CLI behavior or connection issues
- Inspecting verbose logs (debug level)

## Rules

- `force-debug-env` – `XMTP_FORCE_DEBUG` and `XMTP_FORCE_DEBUG_LEVEL`

## Quick start

Set in `.env` or export:

```bash
XMTP_FORCE_DEBUG=true
XMTP_FORCE_DEBUG_LEVEL=debug
```

Read `rules/force-debug-env.md` for details.