MeshCore Bot
Bot Reference
Complete command reference for the MeshCore Bot. Send commands directly on the mesh — most work with or without the ! prefix.
Command Syntax
Prefix
Commands work with or without the ! prefix:
testor!testwx 86301or!wx 86301
Case Sensitivity
Most commands are case-insensitive — TEST and test work the same.
Rate Limiting
The bot implements rate limiting to prevent spam. If you send commands too quickly you may receive a rate-limit message — wait a few seconds before trying again.
Getting Help
Use help to list all commands, or help <command> for details on a specific one.
Basic Commands
test tTest message response to verify bot connectivity and functionality.
Response: Confirms message receipt with connection information.
pingSimple ping/pong to test bot responsiveness.
Response: Pong!
helpShow available commands or get detailed help for a specific command.
helloGreeting response. Also responds to hi, hey, howdy, and greetings.
cmdList all available commands in compact format.
contactShare the bot's own contact card so you can add it and send DMs without waiting for an advert.
versionShow the bot's current software version.
statusShow current bot and radio status details — connection info and health summary.
Information Commands
channelsList and manage hashtag channels on the MeshCore network.
wx <zipcode> weather wxa wxalertGet weather information for a US zip code using NOAA data. Includes current conditions, tonight/tomorrow forecast, and active weather alerts.
gwx <location> globalweather gwxaGlobal weather for any location worldwide using Open-Meteo. Includes temperature, feels-like, wind, humidity, dew point, visibility, pressure, and forecast.
aqi <location>Air Quality Index for a location. Returns US AQI, European AQI (if available), pollutant concentrations, and health recommendations.
rain <location> nowcast snowMinute-level precipitation nowcast — tells you when rain or snow is about to start or stop in the next two hours, worldwide, no API key required.
airplanes aircraft planes adsb overheadAircraft tracking via ADS-B. overhead returns the single closest aircraft above you.
| Option | Description |
|---|---|
| radius=<nm> | Search radius in nautical miles (default 25, max 250) |
| alt=<min>-<max> | Altitude range in feet, e.g. alt=1000-5000 |
| speed=<min>-<max> | Ground speed range in knots |
| type=<code> | Aircraft type code, e.g. B738 |
| callsign=<pattern> | Filter by callsign |
| military | Military aircraft only |
| squawk=<code> | Filter by squawk code |
| limit=<n> | Max results (default 10, max 50) |
| closest / highest / fastest | Sort order |
sunSunrise, sunset, day length, and solar noon for the bot's configured location.
moonMoon phase, moonrise/moonset times, and illumination percentage for the bot's configured location.
auroraAurora visibility forecast for configured or provided coordinates.
solarSolar conditions and HF band status — flux, sunspot number, A/K-index, and band conditions (Open / Marginal / Closed).
solarforecast sfSolar panel production forecast for a location. Optionally specify panel size, azimuth, and tilt angle.
hfcondHF band conditions for amateur radio — band status, solar flux, A/K-index, and propagation conditions.
satpass <NORAD>Upcoming satellite passes for a NORAD ID or shortcut. Add visual for visual-only passes.
n2yo_api_key in config.Emergency Commands
alert <location>Active emergency incidents for a location — type, description, agency, time, and severity. Add all to show every incident.
Alert_Command configuration with agency IDs for your area.Gaming Commands
diceRoll dice with any configuration.
rollRoll a random number. Default range is 1–100.
magic8Ask the Magic 8-Ball a yes/no question.
Entertainment Commands
jokeRandom joke, optionally from a category like programming or pun.
dadjokeRandom dad joke from icanhazdadjoke.com.
hackerResponds to Linux/Unix commands (sudo, ls -l, grep, rm -rf, etc.) with supervillain mainframe error messages.
catfactGet a random cat fact.
Sports Commands
sportsCurrent scores for configured teams or a league.
wc worldcupFIFA World Cup scores and schedule — active only while a tournament is in progress (auto-detected).
MeshCore Utility Commands
path decode routeDecode and display the full routing path your message took through the mesh network, including all intermediate nodes.
trace / tracertrace sends a link trace along a given path. tracer builds a round-trip path so the bot's radio hears the return. Both use your message's incoming path when no path is specified.
prefix <XX>Look up repeaters by two-character prefix. Use prefix free to see available prefixes.
statsBot usage statistics for the past 24 hours.
multitest mtListen for 6 seconds and collect all unique routing paths from incoming messages.
Admin Commands DM Only
Admin commands are only available via Direct Message and may require ACL permissions.
repeater repeaters rp AdminManage repeater contacts and contact list capacity. Handles scanning, listing, purging, and auto-management of the device's contact table.
advert AdminSend a network flood advert to announce the bot's presence. 1-hour cooldown between uses.
reload AdminReload supported runtime configuration without restarting the bot. Connection/radio settings still require a process restart.
channelpause / channelresume AdminTemporarily pause or resume bot responses on public channels. DMs continue to work while paused.
greeter AdminShow greeter behavior and configuration guidance.
feed AdminManage RSS and API feed subscriptions posted to mesh channels.
announcements AdminManage announcement ACL and related settings.
schedule AdminView configured scheduled messages and advert interval.
webviewer web wv AdminManage the web viewer integration — check status, reset the circuit breaker, or restart the process.