Design circuit boards with the agent you already use.
copperflow is a PCB design program that runs on your computer. You draw in the editor, your agent works on the same files through MCP, and every change it makes is one step you can undo.
npm install -g copperflow
The first npm release is in preparation. Until it is out, this command will not find the package.
Start
-
Install it
copperflow needs Node.js 22 or newer.
npm install -g copperflow -
Connect your agent
Make a folder for the board and add copperflow to your agent there. With Claude Code:
mkdir my-board cd my-board claude mcp add copperflow -- copperflow mcpAny other MCP client works the same way: add a server that runs
copperflow mcpin the project folder.{ "mcpServers": { "copperflow": { "command": "copperflow", "args": ["mcp"] } } } -
Open the editor
copperflow studioOpen the address it prints. The address carries a key for this session, so other web pages and other programs on your computer cannot use the editor.
-
Say what you want built
Design a CAN bus node: an MCP2515 controller, a TJA1051 transceiver, an 8 MHz crystal, one header for SPI and one for the bus. Two layers, as small as it routes.
The agent reads the guide that comes with copperflow, so you do not have to explain the tools. Watch the board appear in the editor and step in whenever you like.
Two pairs of hands on one board
- Lock what you have placed
- The agent cannot move or change a locked part. Only you unlock it.
- Leave a note on the board
- Write "route ground under this part" on a part or a spot on the canvas. The agent reads it as an instruction.
- Undo anything
- Each change the agent makes is one entry in the history. Undo it and the agent does not make it again.
- Your files stay yours
- Circuits are plain TSX files in your folder. Edits are written back as small text changes, so the rest of your code stays as you wrote it.
From an idea to files a factory accepts
- A schematic editor and a PCB editor over the same circuit.
- Automatic placement and routing, copper pours and mounting holes, with hand routing where you want it.
- Electrical and design rule checks against a fabrication profile: JLCPCB two-layer by default.
- A parts library where a person, not the agent, marks a part as checked against its datasheet.
- A bill of materials, and Gerber and drill files ready to order.
copperflow is at version 0.3 and early. Expect rough edges, and tell us where you find them.
It stays on your computer
There is no account and nothing is uploaded. This page sets no cookies and loads nothing from other sites. The editor is a page served from your own machine, the agent talks to a program on your own machine, and the project is a folder on your own disk. copperflow is open source under the Apache 2.0 licence.