Leonezz/openbaud

Turn serial hardware into reusable, auditable tools for coding agents.
OpenBaud gives Codex structured access to local serial devices. Inside an agent
task, it makes hardware actions visible and auditable, returns structured
results instead of byte dumps, and turns verified exploration into durable
tools. It combines an MCP server with device profiles, typed commands,
workflows, lossless captures, byte-exact replay, and a hardware-exploration
skill.
Watch the 46-second PV ·
Try without hardware ·
Install for Codex
## Why OpenBaud
A serial terminal can send bytes. An ad-hoc script can make one device work.
OpenBaud keeps the evidence that makes the result repeatable:
Explore safely: identify ports by USB metadata, frame responses, audit
writes, and require explicit acknowledgement for dangerous commands.
Sediment knowledge: turn verified behavior into typed, reviewable YAML
commands and fixed workflows with provenance.
Parse real protocols: validate checksums and decode scalars, bit fields,
split lists, and record arrays into structured results — including data a
device pushes on its own, checked frame by frame.
Refuse what would be wrong: a command declares the device state it
depends on (requires), and is refused before a byte is sent when the
session has not established that state — instead of returning a valid frame
that means something else.
Replay without hardware: record every RX/TX byte in .obcap, then rerun
the same command and parser against the capture.
text
serial device → lossless capture → checksum → typed parse → command → replay
## Real ESP32 demo
The product video uses a physical ESP32-S3 development board running a new
binary protocol, OBP/1. OpenBaud recorded eight hardware exchanges and
decoded every 196-byte response into 36 polar points with CRC-16 verification.
The USB transport, board timestamps, frames, captures, and parsing are real.
The radar scene is generated by the test firmware, and that fact is declared on
the wire as simulatedscene: 1.
Run the exact parser against the included real-device capture:
sh
cargo run --locked -p openbaud -- run openbaud-pv-board/obp1radarscan \
--workspace examples/pv-demo \
--port replay:captures/obp1-radar-seq42.obcap \
--set seq=42
Expected result: outcome: normal, seq: 42, pointcount: 36, and 36
decoded {angledeg, distancemm, intensity} records. The
example workspace includes the command, protocol layout,
and lossless capture.
## Install the Codex plugin
Register this Git repository as the openbaud-marketplace marketplace and
install its plugin:
sh
codex plugin marketplace add Leonezz/openbaud --ref stable
codex plugin add openbaud@openbaud-marketplace
Start a new Codex task, connect a serial device, then ask:
text
Use OpenBaud to identify this serial device. Start read-only, preserve a
capture, and turn verified behavior into reusable commands.
The stable marketplace plugin bundles all five native MCP runtimes and selects
the matching one locally at startup. Users need Node.js 18 or newer for the
portable launcher, but do not need Rust, Cargo, Homebrew, an install hook, or a
runtime download. The supported hosts are macOS ARM64/Intel, Linux x64/ARM64,