Method · repair bench

AI on the repair bench, grounded in your documents.

Drop a schematic PDF and a boardview into WrenchBoard and, about two minutes later, you are working on a device the system actually knows: components inventoried, nets classified, boot sequence mapped, failure rules audited. Here is what happens in those two minutes, and why nothing the agent tells you afterwards is left to chance.

Open a board on the bench free · no account · nothing stored

01Two minutes

Two minutes from documents to working knowledge

A senior technician who has seen a board a hundred times carries its architecture in their head. WrenchBoard builds that mental model explicitly, before the first probe touches the board.

The build is done by a small factory of specialized Claude roles: a Scout gathers what is known about the device, a Registry freezes the component inventory, three Writers work in parallel (one maps the board, one writes the clinical failure picture, one compiles the vocabulary), and an Auditor checks the result before anything is stored. From a schematic PDF and a boardview, the whole pass takes about two minutes.

The output is not prose, it is a queryable corpus on disk, per device. Every diagnostic session that follows reads from it and writes back to it: measurements, confirmed causes, open questions. Nothing restarts from zero.

Sort 4 files

We suggest where each one goes. Nothing is read or analysed until you confirm.

mnt-reform-motherboard.kicad_pcb 16 MB
Boardview format, certain
Boardview Free
mnt-reform-motherboard.pdf 4.2 MB · 12 pages
Circuit sheets on 3 of the first 4 pages
Schematic1 schematic read Yes, this is the circuit schematic of this board. Read it now
INA233.pdf 1.3 MB
Circuit drawings but no schematic sheet: a datasheet or a guide
DatasheetFree
bench-notes.md 2.1 KB
Text notes
NotesFree
3 files filed for free · 1 schematic read Cancel File 4 files and read 1 schematic
Four files, four jobs. The boardview is recognised by its format, the schematic by its sheets, the datasheet by what it is not, and nothing is read until you confirm.

02The graph

The schematic becomes a graph you can query

A sixty-page schematic PDF is documentation for humans with hours to spend. WrenchBoard compiles it, page by page, using Claude vision, into an electrical graph: which nets exist, what class they belong to, which components sit on them, what the boot sequence looks like, with a quality report attached stating how much of the document was confidently read.

That compilation is what turns “search the PDF” into “ask the board a question”. What a specific component does, what shares its rail, what should be live at this boot phase: answers come from the graph in seconds, and they cite the graph, not the model’s memory. The compiler itself has its own page.

What makes +5V, and what dies with it?
Agent
Reading the schematic graph
voltage5 V sourceU7 enable5V_PWR_EN consumers U1U7U17U19U13D12+1 decoupling5 boot phase2
Reading the schematic graph
U7 → +1V2+1V5+5VEDP_BL_VCCUSB_PWRVCC+1 → D12FB12FB15FB2J24U1+6

+5V comes out of U7, enabled by 5V_PWR_EN. If U7 stops, seven rails and twelve parts go with it, U11 and J24 included. Measure on C18, one of its decoupling caps.

Two questions to the graph, one after the other: what a rail is, and what falls with it. Both answers are reads over the compiled graph, so they carry the same names as your schematic.

03The engines

Deterministic engines under the reasoning

The agent does not guess causal chains, it delegates them. Two pure algorithms sit at the core of the diagnostic stack and make zero language-model calls at runtime:

  • The simulator advances the board’s boot sequence phase by phase and emits a timeline: which rails are dead, which components are unpowered, what blocks each phase.
  • The hypothesizer takes a partial observation, the handful of measurements you actually made, and enumerates the one- and two-fault candidates that would explain it, ranked by how well each one fits.

Deterministic means checkable: the same measurements always produce the same candidates, and every causal chain can be verified by hand against the graph. The agent’s job is to reason on top of that scaffolding in plain language, at the level of the technician using it, not to improvise electronics.

Nothing on the battery node. Where do I start?
Agent
Hypotheses from the observations
Observed BAT1FUSED
R9 short D17 open Q5 open Q5 stuck_off L2 dead
To tell them apart, measure Q5D17L2 Measure

Five candidates explain a dead BAT1FUSED, and nothing separates them yet: the observation fits all five. Measure Q5, D17 or L2 and the list splits. Do not start by replacing R9, it is only first alphabetically.

The real ranking on this board, with the observation “BAT1FUSED dead” and nothing else. Five candidates at the same level: the tool does not invent a favorite, it names the measurements that would tell them apart.

04The session

A session at the bench, iron in hand

At the bench, the agent drives the boardview while you work: it highlights the pin to probe, traces the net under suspicion, annotates the measurement protocol on the board itself. If its reasoning needs eyes, it requests a frame from your USB microscope; you can also drop a close-up of a suspect chip into the chat.

You measure, it interprets, the loop continues. Every measurement is logged, every capture is persisted, and the whole session can be replayed afterwards: what was said, what was decided, what the agent actually saw. The full diagnostic workflow is structured the way a senior would run it, but the iron never leaves your hand.

The reading rides along with your next message

BAT1FUSED · 0 V · 14:02 You do not retype it, and the agent reads it before it answers.

Click a pin, press Measure, type what the meter reads. The value is filed on the repair, on the pin it was taken on.

05The limits

The honest limits

WrenchBoard is at its strongest with a schematic and a boardview in hand; that is where verified inventories and deterministic chains operate at full capacity. Without those documents, it still builds a first knowledge pack from public sources: useful, but thinner. That gap is not a software limitation, it is a documentation-access problem, and it is the real subject behind “too complex to repair”. The canonical development target is the MNT Reform mainboard, chosen precisely because its documentation is open under the CERN-OHL-S license.

Watch it work

The same agent, on a real board

This is not a mockup, it is the bench itself with its own interface, running on the MNT Reform pack exported from the engine: 487 real components and 2066 real pads. Every step below is what the engine answers on this board, from the device's rules for the symptom to the schematic graph behind the input fuse F1 and the board net it feeds. Here is what the agent does with a board that will not power up.

WrenchBoard MNT Reform 2 · motherboard Agent
Top Bottom
MNT Reform 2 487 comps · 2066 pads
net Net-(C149-Pad1) · 8 pins

Eight tool calls, each one a real answer from the engine on this board, and not one component named from memory.

FAQ

Frequently asked questions

What exactly is a knowledge pack?

A structured, per-device corpus the system builds before any diagnosis: component inventory, classified nets, inferred boot sequence, known failure rules. It is assembled by four specialized Claude roles (a Scout, a Registry, three parallel Writers, an Auditor) in about two minutes, then stored on disk where every later session can query and enrich it.

Do I need the schematic and the boardview of my device?

The system performs at its best with both: that is where the deterministic engines produce verifiable causal chains. Without them it does not collapse; it builds a first knowledge pack from public sources. The gap between the two is exactly the gap right-to-repair laws are meant to close.

What does deterministic mean here, concretely?

Two engines sit under the agent's reasoning: a boot-sequence simulator that advances phase by phase and emits a timeline of dead rails and dead components, and a hypothesizer that enumerates one- and two-fault candidates explaining a partial observation, ranked against what you measured. Neither makes a language-model call at runtime: same input, same output, every chain checkable by hand.

Can the agent actually see my board?

Yes, on your cue. Plug a USB microscope or webcam into the bench and the agent requests a frame when its reasoning needs one; you can also drop a macro shot into the chat at any time. Captures are persisted with the repair, so a session can be replayed end to end: words, decisions, and the photographs the agent looked at.

What happens if the agent cites a component that does not exist?

It cannot assert one. A reference lookup that fails returns the closest real matches, and the agent must pick from those or ask you. As a second layer, a server-side sanitizer scans every outgoing message and visibly marks any reference it cannot verify against the parsed board before the text reaches your screen.

Get started

Try Wrench Board free, in your browser.

Free plan, no card required. Open the app, pick a covered device, and start a diagnostic session with the agent.

04 Stay in the loop

Wrench Board is live.

The app is live in public beta at app.wrenchboard.cloud, no waitlist, free plan. Leave your email to follow the product: new boardview formats, new device packs, major releases.

register · updates ~/wrench-board
$ notify --on=releases
no spam · unsubscribe anytime
◆ Built for the right-to-repair movement.