copperflow

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.

The copperflow editor showing a routed two-layer board with a CAN controller, a transceiver, a crystal and three pin headers, beside its bill of materials.
A CAN bus node an agent drew, placed and routed in 25 tool calls: 14 parts, all 26 connections routed, no copper rule broken.

Start

  1. Install it

    copperflow needs Node.js 22 or newer.

    npm install -g copperflow
  2. 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 mcp

    Any other MCP client works the same way: add a server that runs copperflow mcp in the project folder.

    {
      "mcpServers": {
        "copperflow": { "command": "copperflow", "args": ["mcp"] }
      }
    }
  3. Open the editor

    copperflow studio

    Open 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.

  4. 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

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.