Neighbors CLI Commands

Explore MeshCore neighbour information using CLI commands to discover nearby nodes, view their details, check signal quality, and understand connectivity across the mesh network.

Updated 29 October 2026

Availability: Repeater Only.

1. List Nearby Neighbours

neighbors

Lists nearby neighbours known to the repeater.

Notes:

Output is limited to the 8 most recent adverts.
Each line is encoded using the following format:

{pubkey-prefix}:{timestamp}:{snr*4}

Field	Description
`pubkey-prefix`	Prefix of the neighbour's public key.
`timestamp`	Timestamp associated with the advert.
`snr*4`	Signal-to-noise ratio (SNR) multiplied by 4.

2. Remove a Neighbour

neighbor.remove <pubkey_prefix>

Removes neighbour entries matching the supplied public key prefix.

Parameter:

pubkey_prefix — The public key of the node to remove. You can supply either a short prefix or the full public key.

Notes:

All neighbours matching the supplied prefix will be removed.
To remove all neighbours, supply a single space character as the prefix. The space represents an empty prefix, which matches all existing neighbours.

⚠️ Warning: Removing neighbours using a short prefix may remove multiple entries if they share that prefix.

3. Discover Zero-Hop Neighbours

discover.neighbors

Discovers zero-hop neighbours.