Easy setup
Hard Fault lets Codex or Claude work with your firmware and physical boards. BYO installs the local tools that connect them.
1. Install BYO
Section titled “1. Install BYO”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)
(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)
(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)
& ([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 -AllowUnsignedLinux — 64-bit, glibc 2.28+ (Terminal)
(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.
2. Open your firmware project
Section titled “2. Open your firmware project”Run this in your project’s folder:
byo initbyo doctorInitialize 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.
3. Connect your board
Section titled “3. Connect your board”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.
4. Start working
Section titled “4. Start working”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.