Files
richandClaude Haiku 5.5 a323342971 Add emoji reactions in the wire format of MeshCore One
Select a message in a channel or a DM and press ^E (Shift+F2 on the handhelds) to
react with an emoji. A reaction is a usual message on the wire: MeshTerm writes the
format of MeshCore One and reads it and the two formats of meshcore-open. The
transcript folds each reaction under the message that it names, with a count, or
the names of the nodes while that message is selected. A reaction does not raise
the unread badge, and the Messages list previews it as "reacted 👍".

A reaction names its target by the sender's timestamp. Thus MeshTerm now gives the
device the timestamp of each message it sends and stores exactly that second. A
retry of a DM keeps the timestamp and counts the try number, as the protocol
specifies. The emoji that ^E offers are the reaction_emoji preference. Rooms have
no reactions.

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
2026-10-15 07:47:13 -04:00
..
2026-10-13 00:06:30 -04:00

MeshTerm documentation

This folder has everything that does not belong on the front page. The README is the front door. It says what MeshTerm is, how to install it, and how to start a first session. This folder has the other documents, in four parts:

Folder What is in it
guide/ How to use MeshTerm: what each screen does, how to configure it, how to connect a companion, and terminals.
cli/ The manual of the command line, and a cookbook of one-line commands.
devices/ How to run MeshTerm on a handheld's own screen, with one manual for each device.
development/ How the code is laid out, how we write, and a historical survey.

Using MeshTerm

Read For
What MeshTerm does Each screen that the menu has, in the same groups as the menu, with the command that does the same job without the menu.
Configuring MeshTerm The difference between preferences and config, the device profiles, and all the files that MeshTerm keeps in ~/.meshterm.
When a companion does not connect Bluetooth pairing on each system, how to find the PIN, and each connection error that MeshTerm reports, with the action to take.
Terminals, icons, and the Windows console Why the icons and charts draw correctly on some terminals and not on others, and what MeshTerm does about it on Windows.

The command line

Read For
The command line The manual. Each subcommand and option, what each prints on the plain face and on the JSON face, the exit statuses, and recipes that use jq.
The CLI cookbook Common one-line commands, in groups by task. Use it when you want the form of a command and not its specification.

Running it on a handheld

Read these documents only if you want to run MeshTerm on a handheld's own screen. A MeshCore companion on USB, Bluetooth, or Wi-Fi does not need them.

Read For
MeshTerm on hardware Start here. It says which of the manuals below is the correct one for you, and what the scripts on the device do.
MeshTerm on the PicoCalc How to change a stock ClockworkPi PicoCalc into a Linux handheld that has a LoRa radio soldered inside: the shopping list, the change to a Luckfox Lyra core, Calculinux, and the radio.
MeshTerm on the uConsole A uConsole (CM4 or CM5) with the hackergadgets AIO LoRa board. Its SX1262 is on the computer's own SPI bus. MeshTerm can control it directly with --spi. Or a small bridge can make it a companion for a node that is always on.
MeshTerm on the Cardputer Zero M5Stack's Linux Cardputer: how to install MeshTerm from the app store, use the Cap LoRa-1262 radio, and try the layout in the desktop emulator.

Reading the code

Read For
How the code is laid out The layers of the code, and where to put a new feature.
How we write How we write: the ASD-STE100 rules and the glossary for docstrings, comments, and documents.
CLAUDE.md The real style guide: the terms, the UX standards, and the building blocks that you can use again. It is written for AI assistants, and it has the house rules for everyone.
CONTRIBUTING.md How to propose a change, the rules for the use of AI, the dev install, the three checks that a change must pass, and what happens to the licensing of your contribution.

Historical record

This is a survey of the code. We keep it, because a project that writes down its own problems is easier to trust than a project that does not. But it is a snapshot of one date, not a list of tasks. Some of the problems that it describes are corrected now, and the survey does not say which.

Read For
UI consistency survey Each other point of the CLAUDE.md UX standard. Six sweeps found nothing, and this is the useful result.

Also here

screenshots/ has the captures that the README shows. It also has the captures from which meshterm.net builds its landing page. Thus more than one place refers to each file in this folder.