Skip to content

feat(cli): doctor diagnostics commands - #3252

Draft
benallfree wants to merge 3 commits into
meshcore-dev:devfrom
MeshEnvy:feature/doctor
Draft

feat(cli): doctor diagnostics commands#3252
benallfree wants to merge 3 commits into
meshcore-dev:devfrom
MeshEnvy:feature/doctor

Conversation

@benallfree

@benallfree benallfree commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

This PR adds a doctor CLI command for repeaters to perform on-device diagnostics. I was hitting LittleFS errors and needed more insight.

Command Remote admin Description
doctor stat No (USB) Partition free/block headroom (FS_STAT on serial)
doctor gc Yes Remove common cruft (/packet_log, legacy prefs paths, doctor temp files)
doctor check Yes Probe atomic prefs write, report prefs/id/acl/regions presence
doctor ls No (USB) Recursive file listing (FS_LS on serial)
doctor probe No (USB) Write-size probe + prefs JSON write test (FS_PROBE on serial)
doctor dump No (USB) Hex dump raw flash region backing InternalFS

Also appends (try: doctor gc) hints to the FS save error replies, and upgrades erase to format+remount when the FS callback is available.

Stacked on #3253 (FS error replies), which stacks on #3254 (atomic saves) — merge those first, then rebase this onto dev. The first two commits here are theirs.

@benallfree benallfree changed the title feat(cli): doctor filesystem diagnostics and recovery feat(cli): doctor diagnostics commands Aug 20, 2026
benallfree and others added 3 commits August 19, 2026 22:17
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant