Case study

FreeMicro: decoding Codex Micro's USB and Bluetooth control protocol

FreeMicro implements Codex Micro key input and LED output through the device's vendor HID protocol, linking six keys to Claude Code project states. Its protocol notes describe different USB and Bluetooth LE report framing, device commands, and observed input events, with Python code for device control.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-06
Evidence class: C2 code & docs, no demo or download

Stars: 33
Last commit: 2026-07-27
Language: Python
License (GitHub): MIT

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Observed: Code, documentation and a download method observed; no demo found.
Checked: 2026-11-09

How evidence classes are assigned

Requirements & limits

Prerequisites: A Codex Micro device, macOS, and Python 3.9+.
Scope: The protocol observations are documented for a shipping unit with firmware v0.4.1.
License: MIT license.

Cite

BibTeX

@misc{freemicro-codex-micro-case,
  title = {{FreeMicro: decoding Codex Micro's USB and Bluetooth control protocol}},
  howpublished = {\url{https://github.com/eliBenven/freemicro}},
  url = {https://github.com/eliBenven/freemicro},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/freemicro-codex-micro-case/}}
}

Plain text

FreeMicro: decoding Codex Micro's USB and Bluetooth control protocol. https://github.com/eliBenven/freemicro (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/freemicro-codex-micro-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

docs/PROTOCOL.md GitHub · eliBenven/freemicro · Revision 64258eb
README.md GitHub · eliBenven/freemicro · Revision 64258eb