Skip to content

Easy setup

Hard Fault lets Codex or Claude work with your firmware and physical boards. BYO installs the local tools that connect them.

Install and sign in to Codex CLI or Claude Code first. Then choose your computer below and run the command.

These commands install the v0.1.8 unsigned preview and check the download’s checksum. No separate Python installation is needed.

Mac — Apple silicon (Terminal)
Terminal window
(set -e; installer=$(curl -fsSL https://github.com/JasonPeng2019/BYO-Installer/releases/download/0.1.8/install.sh); printf '%s\n' "$installer" | sh -s -- --version 0.1.8 --base-url https://github.com/JasonPeng2019/BYO-Installer/releases/download/0.1.8 --sha256 66c8a648cfba41d1de478afc3ec1f6ece8d24b754ede4dfc7c19027569630177 --allow-unsigned)
Mac — Intel (Terminal)
Terminal window
(set -e; installer=$(curl -fsSL https://github.com/JasonPeng2019/BYO-Installer/releases/download/0.1.8/install.sh); printf '%s\n' "$installer" | sh -s -- --version 0.1.8 --base-url https://github.com/JasonPeng2019/BYO-Installer/releases/download/0.1.8 --sha256 bc40953e558676d43565af2de147f1665ba7ee9a779d84d58cc5d74ee70d192d --allow-unsigned)
Windows — 64-bit (PowerShell)
Terminal window
& ([scriptblock]::Create((New-Object System.Net.WebClient).DownloadString('https://github.com/JasonPeng2019/BYO-Installer/releases/download/0.1.8/install.ps1'))) -Version 0.1.8 -BaseUrl 'https://github.com/JasonPeng2019/BYO-Installer/releases/download/0.1.8' -Sha256 cf2ead609b533d531d77f4bac8393e2ef5125daa168d9f2106d17e85ee7aaa6e -AllowUnsigned
Linux — 64-bit, glibc 2.28+ (Terminal)
Terminal window
(set -e; installer=$(curl -fsSL https://github.com/JasonPeng2019/BYO-Installer/releases/download/0.1.8/install.sh); printf '%s\n' "$installer" | sh -s -- --version 0.1.8 --base-url https://github.com/JasonPeng2019/BYO-Installer/releases/download/0.1.8 --sha256 d5b2c624f58caa13e9a31c8a6b54fdd0407957a282a460841eec5a97a8f95b85 --allow-unsigned)

On Mac and Linux, open a new terminal after installing. The Windows command makes byo available in the current PowerShell window.

Run this in your project’s folder:

Terminal window
byo init
byo doctor

Initialize each project once. Then launch your client:

Client Command
Codex byo codex firmware
Claude Code byo claude firmware

The MCP server starts automatically. Restart any client that was open during setup.

Connect power and a compatible debug probe. Connect UART if you need serial output. Have the exact MCU part number and its official datasheet saved as a PDF.

Send this to your agent, filling in the blanks:

Set up my <board name> using setup-full.
The MCU is <exact part number>.
The datasheet PDF is at <path>.
Use UART at <baud rate>, or skip UART.

Choose your board if the agent finds several. Review any setup questions. Start with full setup; see Board safety for the other levels.

Tell the agent what to build, fix, or test. For example:

Build the firmware, flash the application, and check the UART startup message.

The agent checks what the board can do and asks for any required approval. You can also say “no board” and work on code and host tests.

For larger tasks, see Manual skills. If something fails, see Using Hard Fault.