# Terminal Chat CLI Commands

## Terminal Chat CLI

Below are the commands you can enter into the Terminal Chat **client** (the companion/serial chat client). These are the Terminal Chat client commands, which differ from the repeater serial-console commands used elsewhere in this book. They are entered bare, with no host-tool prefix. Other pages that show `meshcli ...` are referring to a separate host-side tool with its own syntax - do not mix the two. For the on-device repeater serial CLI, see the canonical command reference at [docs.meshcore.io/cli\_commands](https://docs.meshcore.io/cli_commands).

```
set freq {frequency}
```

Set the LoRa frequency. Example: set freq 915.8

```
set tx {tx-power-dbm}
```

Sets LoRa transmit power in dBm.

```
set name {name}
```

Sets your advertisement name.

```
set lat {latitude}
```

Sets your advertisement map latitude. (decimal degrees)

```
set lon {longitude}
```

Sets your advertisement map longitude. (decimal degrees)

```
set dutycycle {percent}
```

Sets the transmit duty cycle limit (1-100%). Example: `set dutycycle 10` for 10%. Note: duty-cycle limiting is a regulatory requirement in the EU 868 MHz band (ETSI), not in the US 902-928 MHz band, where 47 CFR 15.247 uses frequency-hopping / digital-modulation rules instead. US operators are not subject to a duty-cycle cap, but courteous airtime limits still help network health.

```
set af {air-time-factor}
```

Sets the transmit air-time-factor. Deprecated - use `set dutycycle` instead.

```
time {epoch-secs}
```

Set the device clock using UNIX epoch seconds. Example: time 1738242833

```
advert
```

Sends an advertisement packet

```
clock
```

Displays current time per device's clock.

```
ver
```

Shows the device version and firmware build date.

```
card
```

Displays *your* 'business card', for other to manually \_import\_

```
import {card}
```

Imports the given card to your contacts.

```
list {n}
```

List all contacts by most recent. (optional {n}, is the last n by advertisement date)

```
to
```

Shows the name of current recipient contact. (for subsequent 'send' commands)

```
to {name-prefix}
```

Sets the recipient to the \_first\_ matching contact (in 'list') by the name prefix. (ie. you don't have to type whole name)

```
send {text}
```

Sends the text message (as DM) to current recipient.

```
reset path
```

Resets the path to current recipient, for new path discovery.

```
public {text}
```

Sends the text message to the built-in 'public' group channel