← Back to Hub

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:

  • test or !test
  • wx 86301 or !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 t

Test message response to verify bot connectivity and functionality.

Usage
test t hello world

Response: Confirms message receipt with connection information.

ping

Simple ping/pong to test bot responsiveness.

Usage
ping

Response: Pong!

help

Show available commands or get detailed help for a specific command.

Usage
help help wx help repeater
hello

Greeting response. Also responds to hi, hey, howdy, and greetings.

cmd

List all available commands in compact format.

contact

Share the bot's own contact card so you can add it and send DMs without waiting for an advert.

version

Show the bot's current software version.

status

Show current bot and radio status details — connection info and health summary.

Information Commands

channels

List and manage hashtag channels on the MeshCore network.

Usage
channels channels list channels emergency channels #general
wx <zipcode> weather wxa wxalert

Get weather information for a US zip code using NOAA data. Includes current conditions, tonight/tomorrow forecast, and active weather alerts.

Usage
wx 86301 weather 86303 wxa 86325
gwx <location> globalweather gwxa

Global weather for any location worldwide using Open-Meteo. Includes temperature, feels-like, wind, humidity, dew point, visibility, pressure, and forecast.

Usage
gwx Tokyo gwx Paris, France gwx 35.6762,139.6503
aqi <location>

Air Quality Index for a location. Returns US AQI, European AQI (if available), pollutant concentrations, and health recommendations.

Usage
aqi prescott aqi 47.6,-122.3 aqi help
rain <location> nowcast snow

Minute-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.

Usage
rain rain prescott rain 34.54,-112.47 snow flagstaff
Example responses
🌧️ Rain starting in ~25min for Prescott (~45min) ☀️ No rain expected in next 2h for Prescott
airplanes aircraft planes adsb overhead

Aircraft tracking via ADS-B. overhead returns the single closest aircraft above you.

Filter options
OptionDescription
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
militaryMilitary aircraft only
squawk=<code>Filter by squawk code
limit=<n>Max results (default 10, max 50)
closest / highest / fastestSort order
Examples
airplanes airplanes military airplanes type=B738 airplanes radius=50 closest overhead
sun

Sunrise, sunset, day length, and solar noon for the bot's configured location.

moon

Moon phase, moonrise/moonset times, and illumination percentage for the bot's configured location.

aurora

Aurora visibility forecast for configured or provided coordinates.

Usage
aurora aurora 34.54,-112.47
solar

Solar conditions and HF band status — flux, sunspot number, A/K-index, and band conditions (Open / Marginal / Closed).

solarforecast sf

Solar panel production forecast for a location. Optionally specify panel size, azimuth, and tilt angle.

Usage
sf prescott sf prescott 200 sf prescott 200 180 45 sf 34.54,-112.47 150
hfcond

HF 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.

Shortcuts
iss tiangong noaa15 noaa18 noaa19 goes16 goes17 goes18 hubble starlink
Examples
satpass iss satpass iss visual satpass noaa19 satpass 25544
Requires 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.

Usage
alert prescott alert 86301 alert prescott all alert yavapai county
Requires Alert_Command configuration with agency IDs for your area.

Gaming Commands

dice

Roll dice with any configuration.

Usage
dice (standard d6) dice d20 dice 2d6 dice 3d10
roll

Roll a random number. Default range is 1–100.

Usage
roll roll 50 roll 1000
magic8

Ask the Magic 8-Ball a yes/no question.

Examples
magic8 will the mesh be busy tonight? magic8 should I deploy another node?

Entertainment Commands

joke

Random joke, optionally from a category like programming or pun.

dadjoke

Random dad joke from icanhazdadjoke.com.

hacker

Responds to Linux/Unix commands (sudo, ls -l, grep, rm -rf, etc.) with supervillain mainframe error messages.

catfact

Get a random cat fact.

Sports Commands

sports

Current scores for configured teams or a league.

Usage
sports sports seahawks sports nfl sports mlb sports fifa
wc worldcup

FIFA World Cup scores and schedule — active only while a tournament is in progress (auto-detected).

Usage
wc wc argentina

MeshCore Utility Commands

path decode route

Decode and display the full routing path your message took through the mesh network, including all intermediate nodes.

trace / tracer

trace 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.

Usage
trace 01,7a,55 tracer 01,7a,55 tracer
prefix <XX>

Look up repeaters by two-character prefix. Use prefix free to see available prefixes.

Usage
prefix 1A prefix 2B all prefix free prefix refresh
stats

Bot usage statistics for the past 24 hours.

Usage
stats stats messages stats channels stats paths
multitest mt

Listen 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 Admin

Manage repeater contacts and contact list capacity. Handles scanning, listing, purging, and auto-management of the device's contact table.

Key subcommands
repeater scan repeater list repeater status repeater manage repeater purge 30 repeater purge all repeater stats repeater discover
advert Admin

Send a network flood advert to announce the bot's presence. 1-hour cooldown between uses.

reload Admin

Reload supported runtime configuration without restarting the bot. Connection/radio settings still require a process restart.

channelpause / channelresume Admin

Temporarily pause or resume bot responses on public channels. DMs continue to work while paused.

greeter Admin

Show greeter behavior and configuration guidance.

feed Admin

Manage RSS and API feed subscriptions posted to mesh channels.

Usage
feed subscribe rss <url> <channel> [name] feed unsubscribe <id> <channel> feed list feed status <id> feed test <url>
announcements Admin

Manage announcement ACL and related settings.

schedule Admin

View configured scheduled messages and advert interval.

webviewer web wv Admin

Manage the web viewer integration — check status, reset the circuit breaker, or restart the process.

Usage
webviewer status webviewer reset webviewer restart