V2.11A clearer README with the demo video ›

Describe a circuit board. Get one you can order.

Viaduct is a Claude Code plugin that designs printed circuit boards. Say what the board should do; it picks real parts, draws the schematic, places and routes the board in KiCad, checks it, and hands you Gerbers, a BOM and a pick-and-place file.

Claude Code KiCad 9 macOS and Windows JLCPCB or any fab house
3D render of an RP2040 climate logger board Viaduct designed, placed and routed
RP2040 climate logger · 44 parts · routed by Viaduct

Watch it work

One sentence to a board, in 35 seconds

Real KiCad output from the plugin's test boards. Sound on for the voiceover.

Examples

Boards it designed, start to finish

Each one came from a written description. Times are the total from description to manufacturing files, from the latest test run.

How it works

The steps a PCB designer takes, in order

Every step leaves a normal KiCad 9 project you can open and change. Claude asks when a choice changes the design and says up front what will be automatic.

Read how it works ›

  1. 01

    Requirements

    One round of questions: size, power, connectors and their edges, how you'll build it, anything noise-sensitive.

    requirements
  2. 02

    Parts and schematic

    Verified building blocks and real parts with stock numbers. Every pin is checked against KiCad's libraries before anything is drawn.

    .kicad_sch
  3. 03

    Layer count

    2, 4 or 6 layers, chosen from the design's complexity and explained, or set by you.

    stackup
  4. 04

    Placement

    Connectors flush to their edges, decoupling capacitors at their pins, room for chips to fan out, noisy parts away from sensitive ones.

    .kicad_pcb
  5. 05

    Routing and checks

    Autorouted with ground pours and stitching, then DRC, electrical and noise checks.

    DRC report
  6. 06

    Manufacturing files

    Gerbers and drill files, a BOM and a pick-and-place file in JLCPCB's format, with an ordering checklist.

    fab/

New in V2.5

2, 4 or 6 layers. Or let it decide.

On Auto, Viaduct compares your design with real routed boards and picks the layer count, then tells you why.

auto

4 layers for BGAs, high-speed interfaces like Ethernet or DDR, or when most similar boards use 4. Otherwise 2.

2

Cheapest. Right for most hobby and product boards.

4

A solid ground plane and a power plane inside the board.

6

Both planes plus two inner signal layers.

F.Cu
signals
In1.Cu
GND plane
In2.Cu
+3V3 plane
B.Cu
signals

The 4-layer ESP32-C3 example: planes on In1 and In2, routed in 10 seconds, DRC clean.

Commands

Four commands in Claude Code

/viaduct:design

An idea to a board ready to order.

/viaduct:review

Check any KiCad project before you order it.

/viaduct:inquiry

Ask a question, or get feedback on a schematic or board.

/viaduct:fab

Gerbers, BOM, pick-and-place and an ordering checklist.

Install

Two commands

Run these in Terminal on macOS or PowerShell on Windows, then start Claude Code.

$claude plugin marketplace add virajrungta/viaduct
$claude plugin install viaduct@viaduct

Needs Claude Code, KiCad 9 and Java 21+. Full setup guide ›

Changelog

  • V2.11

    A clearer README, with the demo video

    2026-11-08
  • V2.10

    New website address: [viaduct-pcb.github.io](https://viaduct-pcb.github.io/)

    2026-11-08
  • V2.9

    Startup script the plugin directory can read

    2026-11-08
  • V2.8

    Ready for Claude's plugin directory

    2026-11-07
All releases ›

Your next board starts as a sentence.

Free and open source. Your boards stay on your machine.