Hard Fault documentation
Hard Fault is a local embedded-debug and firmware agent built around pyOCD, Stage 0 validation tooling, and an MCP server. It flashes images, reads UART, and drives SWD on a real board, with a multi-provider “brain” that plans and runs actions behind safety guardrails.
Where to go next
Section titled “Where to go next”- Getting started — install
uv, sync the environment, and run your first task. - Bench bring-up — host setup and Stage 0 validation for a board on your bench.
- Supported boards — the targets it runs on today.
- Providers & auth — pick and authenticate a model backend.
- MCP server & tools — the governed tool surface.
- Guardrails — flash gates, recover gates, and watchers.
Two ways to drive it
Section titled “Two ways to drive it”pyocd-debug— an operator shell with live tool and progress output for hands-on work.pyocd-debug-brain— a headless turnkey CLI for scripted and benchmark runs.
Both run over the same brain and the same governed action surface.