From 1693367f41ae882367b4f1dce7be08d01ca33678 Mon Sep 17 00:00:00 2001 From: Jean-Pierre Martineau Date: Wed, 12 Aug 2026 16:40:27 -0400 Subject: [PATCH] Main menu: every description inside the 72-column line MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The label column is the widest tool title plus two cells of gap, which leaves the muted description 47 to work in. All 22 of them ran past it — "Act on the device itself — clock, backup, identity key, reboot, reset" needed 94 columns of terminal to say what 67 could. The row scrolled under ←→ rather than lying, but a description you have to scroll is a description nobody reads. Rewritten to fit: the subject moves into the title's shadow (the row already says Device actions, so the description just lists them), the parenthetical asides go, and the trailing clause that repeated the obvious goes with them. Widest row is now exactly 72. Co-Authored-By: Claude Opus 5 (1M context) --- meshterm/tools/about.py | 6 +++--- meshterm/tools/advert.py | 2 +- meshterm/tools/channels.py | 2 +- meshterm/tools/chat.py | 2 +- meshterm/tools/config.py | 2 +- meshterm/tools/contacts.py | 2 +- meshterm/tools/courier.py | 2 +- meshterm/tools/dashboard.py | 2 +- meshterm/tools/device_actions.py | 2 +- meshterm/tools/livefeed.py | 2 +- meshterm/tools/map.py | 2 +- meshterm/tools/records.py | 2 +- meshterm/tools/repeater_admin.py | 2 +- meshterm/tools/timemachine.py | 2 +- meshterm/tools/trace.py | 4 ++-- meshterm/tools/tx_optimize.py | 2 +- meshterm/tools/walk.py | 2 +- meshterm/tools/watchtower.py | 2 +- 18 files changed, 21 insertions(+), 21 deletions(-) diff --git a/meshterm/tools/about.py b/meshterm/tools/about.py index 8a990a6..c445aef 100644 --- a/meshterm/tools/about.py +++ b/meshterm/tools/about.py @@ -84,7 +84,7 @@ class AboutMeshTermTool(_AboutTool): name = "about" title = "About MeshTerm" icon = "📖" - help = "What this is, where it came from, and the terms it ships under" + help = "What this is, and the terms it ships under" order = 10 # the question a stranger asks first @staticmethod @@ -102,7 +102,7 @@ class AboutAuthorTool(_AboutTool): name = "about-author" title = "About the author" icon = "👤" - help = "The person behind MeshTerm, on the mesh and off it" + help = "The person behind MeshTerm, on and off the mesh" order = 20 # who made the thing you just read about @staticmethod @@ -120,7 +120,7 @@ class SupportProjectTool(_AboutTool): name = "support" title = "Support this project" icon = "💰" - help = "What keeps MeshTerm going, and the ways to help it along" + help = "What keeps MeshTerm going, and how to help" order = 30 # the ask, and only once the first two have earned it @staticmethod diff --git a/meshterm/tools/advert.py b/meshterm/tools/advert.py index 26b4707..9dca384 100644 --- a/meshterm/tools/advert.py +++ b/meshterm/tools/advert.py @@ -27,7 +27,7 @@ class SendAdvertTool(Tool): name = "advert" title = "Send advert" icon = "📡" - help = "Announce this node to the mesh — zero-hop, flood, or share as QR" + help = "Announce this node — zero-hop, flood, or QR" category = "This node" order = 40 # your own node announcing itself: a device action, not a view popup = True # dialog-sized: float over the menu instead of replacing it diff --git a/meshterm/tools/channels.py b/meshterm/tools/channels.py index d31122f..5fa47c4 100644 --- a/meshterm/tools/channels.py +++ b/meshterm/tools/channels.py @@ -37,7 +37,7 @@ class ChannelsTool(Tool): name = "channels" title = "Channels" icon = "📻" - help = "Create, join, and share mesh channels (with QR codes)" + help = "Create, join, and share mesh channels" category = "Message" order = 20 diff --git a/meshterm/tools/chat.py b/meshterm/tools/chat.py index 084bfa4..7b4391f 100644 --- a/meshterm/tools/chat.py +++ b/meshterm/tools/chat.py @@ -57,7 +57,7 @@ class ChatTool(Tool): name = "chat" title = "Chat" icon = "💬" - help = "Channel and direct messaging — live chat, with stored history" + help = "Channel and direct messaging, with history" category = "Message" order = 10 diff --git a/meshterm/tools/config.py b/meshterm/tools/config.py index 4b6c977..227a068 100644 --- a/meshterm/tools/config.py +++ b/meshterm/tools/config.py @@ -37,7 +37,7 @@ class ConfigTool(Tool): name = "config" title = "Device configuration" icon = "🔧" - help = "View and change device settings — identity, radio, tuning, …" + help = "Device settings — identity, radio, tuning, …" category = "This node" order = 20 diff --git a/meshterm/tools/contacts.py b/meshterm/tools/contacts.py index 3dc76d3..f61a22d 100644 --- a/meshterm/tools/contacts.py +++ b/meshterm/tools/contacts.py @@ -17,7 +17,7 @@ class ContactsTool(Tool): name = "contacts" title = "Contacts" icon = "👥" - help = "List this node and known contacts (last heard, packets, type, key)" + help = "Known contacts — last heard, packets, type" category = "Message" order = 40 # the address book the three above pick their recipient from diff --git a/meshterm/tools/courier.py b/meshterm/tools/courier.py index fa5f0ca..dc76a48 100644 --- a/meshterm/tools/courier.py +++ b/meshterm/tools/courier.py @@ -33,7 +33,7 @@ class CourierTool(Tool): name = "courier" title = "Courier" icon = "📨" - help = "Store-and-forward outbox — deliver when the contact is next heard" + help = "Outbox that delivers when a contact is heard" category = "Message" order = 30 # after Chat and Channels: the same conversations, minus the waiting around diff --git a/meshterm/tools/dashboard.py b/meshterm/tools/dashboard.py index cb86d08..040eb7d 100644 --- a/meshterm/tools/dashboard.py +++ b/meshterm/tools/dashboard.py @@ -29,7 +29,7 @@ class DashboardTool(Tool): name = "dashboard" title = "Dashboard" icon = "📊" - help = "Watch the mesh live — activity, traffic, RF health" + help = "The mesh live — activity, traffic, RF health" category = "Watch" order = 10 # the section's overview, above the tools it summarizes diff --git a/meshterm/tools/device_actions.py b/meshterm/tools/device_actions.py index f22ae73..e08139f 100644 --- a/meshterm/tools/device_actions.py +++ b/meshterm/tools/device_actions.py @@ -29,7 +29,7 @@ class DeviceActionsTool(Tool): name = "device-actions" title = "Device actions" icon = "🔨" - help = "Act on the device itself — clock, backup, identity key, reboot, reset" + help = "Clock, backup, identity key, reboot, reset" category = "This node" order = 30 diff --git a/meshterm/tools/livefeed.py b/meshterm/tools/livefeed.py index 9a4dc3a..05df986 100644 --- a/meshterm/tools/livefeed.py +++ b/meshterm/tools/livefeed.py @@ -29,7 +29,7 @@ class LiveFeedTool(Tool): name = "livefeed" title = "Live feed" icon = "📰" - help = "Every packet as it arrives, newest first — open any in the viewer" + help = "Every packet as it arrives, newest first" category = "Watch" order = 20 # right under the dashboard it was promoted out of diff --git a/meshterm/tools/map.py b/meshterm/tools/map.py index b22aa37..27fb86f 100644 --- a/meshterm/tools/map.py +++ b/meshterm/tools/map.py @@ -37,7 +37,7 @@ class MapTool(Tool): name = "map" title = "Map" icon = "🌍" - help = "Show mesh nodes on a street map (pannable; repeaters highlighted)" + help = "Mesh nodes on a pannable street map" category = "Explore" order = 10 diff --git a/meshterm/tools/records.py b/meshterm/tools/records.py index efb4217..74e7637 100644 --- a/meshterm/tools/records.py +++ b/meshterm/tools/records.py @@ -31,7 +31,7 @@ class TrophyCaseTool(Tool): name = "records" title = "Trophy case" icon = "🏆" - help = "Record-setting mesh walks, scored from every trace" + help = "Record-setting walks, scored from every trace" category = "Explore" order = 40 # what the two walks above it score into diff --git a/meshterm/tools/repeater_admin.py b/meshterm/tools/repeater_admin.py index d54ddbe..99c071c 100644 --- a/meshterm/tools/repeater_admin.py +++ b/meshterm/tools/repeater_admin.py @@ -30,7 +30,7 @@ class RepeaterAdminTool(Tool): name = "repeater-admin" title = "Repeater admin" icon = "🗼" - help = "Set up a remote repeater — settings, actions, command line" + help = "Run a remote repeater — settings and actions" category = "Other nodes" order = 10 # the remote sibling of the local config tools diff --git a/meshterm/tools/timemachine.py b/meshterm/tools/timemachine.py index e218b75..6b2baa7 100644 --- a/meshterm/tools/timemachine.py +++ b/meshterm/tools/timemachine.py @@ -27,7 +27,7 @@ class TimeMachineTool(Tool): name = "timemachine" title = "Time machine" icon = "⏳" - help = "Explore the recorded history — timelines, rhythms, arrivals" + help = "Recorded history — timelines, rhythms, arrivals" category = "Watch" order = 40 # the past tense of the Dashboard above it diff --git a/meshterm/tools/trace.py b/meshterm/tools/trace.py index 91e1fbb..cc43a68 100644 --- a/meshterm/tools/trace.py +++ b/meshterm/tools/trace.py @@ -48,7 +48,7 @@ class TraceTool(Tool): name = "trace" title = "Trace target" icon = "🎯" - help = "Trace a target over a mirrored route and watch per-hop SNR" + help = "Trace a target and watch per-hop SNR" category = "Explore" order = 30 # see a node above, walk to it here @@ -237,7 +237,7 @@ class TracePathTool(Tool): name = "trace-path" title = "Trace path" icon = "👣" - help = "Walk a hand-composed route — out and back your way" + help = "Walk a route you compose, hop by hop" category = "Explore" order = 32 diff --git a/meshterm/tools/tx_optimize.py b/meshterm/tools/tx_optimize.py index 2f0b521..e996a0b 100644 --- a/meshterm/tools/tx_optimize.py +++ b/meshterm/tools/tx_optimize.py @@ -40,7 +40,7 @@ class TxOptimizeTool(Tool): name = "tx-optimize" title = "TX optimize" icon = "📶" - help = "Tune a remote node's TX power for the best signal at a target" + help = "Tune a remote node's TX power for a target" category = "Other nodes" order = 20 # like Repeater admin: a remote radio, changed over the mesh diff --git a/meshterm/tools/walk.py b/meshterm/tools/walk.py index 030655f..1e74832 100644 --- a/meshterm/tools/walk.py +++ b/meshterm/tools/walk.py @@ -35,7 +35,7 @@ class WalkTool(Tool): # the column the others align to. The wireframe globe reads as the logical topology, # the geographic map's 🌍 counterpart. icon = "🌐" - help = "Walk the mesh's observed topology — links, SNR, evidence" + help = "Walk the observed topology — links and SNR" category = "Explore" order = 20 # beside Map: the logical shape next to the geographic one diff --git a/meshterm/tools/watchtower.py b/meshterm/tools/watchtower.py index 6078324..53a5aba 100644 --- a/meshterm/tools/watchtower.py +++ b/meshterm/tools/watchtower.py @@ -29,7 +29,7 @@ class WatchtowerTool(Tool): name = "watchtower" title = "Watchtower" icon = "🚨" - help = "Alerts for watched nodes — silence, SNR sag, new arrivals" + help = "Alerts on watched nodes — silence, SNR sag" category = "Watch" order = 30 # after the live views: the section's always-on alerting eye