numogram: Hermes debugs your ESP32
From its catalog listing
Hermes debugs ESP32 firmware on real hardware. It watches the board's serial port, maps crash addresses to source lines from the ELF, fixes the code, builds with idf.py and flashes with esptool, then reads the log to confirm the fix. A crash wakes the session on its own. Also checks firmware GPIO use against a KiCad netlist (swapped signals, strapping, flash and USB pins) and audits chip security read-only. NUMOGRAM_PORT=virtual runs an emulated ESP32-C3 in Espressif's QEMU, so it works without a board.
Good to know before installing
board_build and board_flash go through Hermes's approval prompt (a pre_tool_call hook, one approval rule per tool) and are blocked when nobody can answer; a build runs ESP-IDF's export.sh, idf.py and the project's own CMake and Python scripts and writes the build directory it is given. Runs esptool, espefuse summary (read-only; the plugin has no eFuse write) and, for the virtual board only, Espressif's qemu-system-riscv32 with networking off, always with fixed argument lists, and each child gets an environment allowlist (PATH, HOME, locale, ESP-IDF variables), never Hermes's keys or tokens. Background: a serial watcher thread while watching is on, and a QEMU process for the virtual board that stops when Hermes exits. Network: none beyond loopback (unauthenticated) to its own macOS USB bridge or virtual board, or the socket:// address set in NUMOGRAM_PORT. Reads the project, build, ELF and netlist paths it is given; writes its own state only under the active Hermes profile's home (get_hermes_home() / numogram). Serial output is passed to the model as untrusted data; wake-up messages are built from fixed text and validated hex. The bridge and virtual board drop eFuse write commands. No credentials, no telemetry.
From its catalog listing.
How to install
- Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
hermes plugins install numogram - Said no? Turn it on later:
hermes plugins enable numogram - Restart Hermes so it loads the plugin.
Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).
- Category
- Everyday life & fun
- Maintained by
- zblauser (Community)
- Needs
- No API keys declared
- Adds tools
board_buildboard_pinsboard_statusboard_watchboard_logboard_flashboard_crashboard_auditboard_note- Adds hooks
pre_tool_callpre_llm_callpost_llm_call- Works on
- linux, macos
- Needs Hermes
- 0.22.7 or newer
- Version
- 0.1.2
- In the catalog
- 2026-11-10
Known issues (from its catalog listing)
- One board at a time. Building and flashing need an ESP-IDF project; board_build needs ESP-IDF where Hermes runs.
- Tested end to end on an ESP32-P4 over USB-Serial/JTAG and on the emulated ESP32-C3. Other chips use the same paths but are untested on hardware; crash parsing on Xtensa chips (ESP32, S2, S3) is untested.
- The macOS bridge supports boards on the chip's own USB-Serial/JTAG port, not boards behind a USB-UART bridge chip.
- The virtual board needs Espressif's qemu-system-riscv32 (idf_tools.py install qemu-riscv32).
Using the Hermes desktop app? See where plugins live

Full setup & settings ↗Source code ↗
More in everyday life & fun
All everyday life & fun plugins
New Hermes Agent updates every day on X. Follow @HermesWatcher