mqttv5 - MQTT v5.0 Command Line Interface

A unified MQTT v5.0 CLI tool with pub, sub, and broker commands.

Features

• Unified interface: Single binary with pub, sub, and broker subcommands
• Smart prompting: Interactive prompts for missing arguments
• Input validation: Helpful error messages with correction suggestions
• Full MQTT v5.0: Complete protocol support
• Session management: Clean start, session expiry, and persistence
• Will message support: Last will and testament with delay and QoS options
• Automatic reconnection: Opt-in reconnection with exponential backoff
• Multi-transport: TCP, TLS, and WebSocket support
• Cross-platform: Should work on Linux, macOS, and Windows

Installation

cargo install mqttv5-cli

Usage

Publishing Messages

# Basic publish
mqttv5 pub --topic "sensors/temperature" --message "23.5°C"

# With QoS and retain
mqttv5 pub -t "sensors/temperature" -m "23.5°C" --qos 1 --retain

# Interactive mode (prompts for missing args)
mqttv5 pub

Subscribing to Topics

# Basic subscribe
mqttv5 sub --topic "sensors/+"

# Verbose mode shows topic names
mqttv5 sub -t "sensors/#" --verbose

# Subscribe for specific message count
mqttv5 sub -t "test/topic" --count 5

# Session persistence and QoS
mqttv5 sub -t "data/#" --qos 2 --no-clean-start --session-expiry 3600

# Auto-reconnect on disconnect (opt-in)
mqttv5 sub -t "sensors/+" --auto-reconnect

Running a Broker

# Start broker on default port
mqttv5 broker

# Custom port and bind address
mqttv5 broker --host 0.0.0.0:1883

# Interactive configuration
mqttv5 broker

CLI Design

• Clear, actionable error messages with suggestions
• Intelligent prompting for missing required arguments
• Unified tool: One binary for all MQTT operations
• Consistent flags and intuitive interface
• Full MQTT v5.0 support including properties and reason codes

Connection Behavior

By default, the CLI exits immediately when the broker disconnects. This prevents duplicate topic takeover issues when clients reconnect with the same client ID.

Use --auto-reconnect to enable automatic reconnection with exponential backoff. When enabled:

• The library handles reconnection automatically
• Subscriptions are restored based on session state
• The client continues running until Ctrl+C or target message count reached

Examples

Publishing sensor data

mqttv5 pub -t "home/living-room/temperature" -m "22.5" --qos 1

Monitoring all home sensors

mqttv5 sub -t "home/+/+" --verbose

Testing with retained messages

mqttv5 pub -t "config/device1" -m '{"enabled": true}' --retain

Advanced MQTT v5.0 Features

# Will messages for device monitoring
mqttv5 pub -t "sensors/data" -m "active" \
  --will-topic "sensors/status" --will-message "offline" --will-delay 5

# Authentication and session management
mqttv5 sub -t "secure/data" --username user1 --password secret \
  --no-clean-start --session-expiry 7200

# Custom keep-alive and transport options
mqttv5 pub -t "test/topic" -m "data" --keep-alive 120 \
  --url "mqtts://secure-broker:8883"

# WebSocket transport
mqttv5 pub --url "ws://broker:8080/mqtt" -t "test/websocket" -m "WebSocket message"
mqttv5 sub --url "wss://secure-broker:8443/mqtt" -t "test/+"

Environment Variables

• MQTT_HOST: Default broker host (default: localhost)
• MQTT_PORT: Default broker port (default: 1883)

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.