mqttv5 - Superior MQTT v5.0 Command Line Interface

A unified MQTT v5.0 CLI tool that replaces mosquitto_pub, mosquitto_sub, and mosquitto with superior ergonomics and user experience.

Features

• Unified Interface: Single binary with pub, sub, and broker subcommands
• Smart Prompting: Interactive prompts for missing arguments
• Superior Error Messages: Helpful validation with correction suggestions
• Full MQTT v5.0: Complete protocol support including all v5.0 features
• Cross-Platform: Works 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

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

Key Advantages over mosquitto

1. Better Error Messages: Clear, actionable error messages with suggestions
2. Smart Defaults: Intelligent prompting for missing required arguments
3. Unified Tool: One binary replaces mosquitto_pub, mosquitto_sub, and mosquitto
4. Modern CLI Design: Consistent flags and intuitive interface
5. Full v5.0 Support: All MQTT v5.0 features including properties and reason codes

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

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.