PCBoo turns a project folder into a complete circuit workspace. Compose boards in TypeScript, ask your existing agent to edit them, and inspect every result in the browser.
The repository is the interface.
PCBoo is not another visual editor and not another agent runtime. It gives coding agents a precise filesystem contract, deterministic commands, and compact results they can reason about.
Humans stay in the loop through a local inspection server—and can hand off to KiCad when fine manual adjustment is the right tool.
One project. Normal files. A small set of commands that agents can run, inspect, and repair without a proprietary UI.
Split the board into small, named components. Import and combine them just like application code.
import { Board, Circuit } from "pcboo";
import { addPower } from "./power";
export default function createCircuit() {
const circuit = new Circuit();
const board = new Board({
width: "30mm", height: "20mm",
layers: 4
});
addPower(board);
circuit.add(board);
return circuit;
}Use Codex, Claude Code, Cursor, or any filesystem-capable coding agent. No special chat surface required.
Get concise diagnostics for the agent and visual board, schematic, layer, and measurement views for the human.
PCBoo keeps independent validation dimensions separate. A manufacturable layout never silently implies a passing simulation, available parts, or standards compliance.
Passing one dimension never changes another. Unavailable work remains visible in reports and manifests.
Compile twice, normalize Circuit JSON, and detect ordinary nondeterminism or undeclared inputs.
01 ↗Pan, zoom, filter layers, select geometry, measure, and trigger bounded derived actions from loopback.
02 ↗Named testbenches, explicit models, bounded solver execution, and independent numeric assertions.
03 ↗Create a detached, validated KiCad project for the moments when manual CAD adjustment is valuable.
04 ↗Generate and independently reconcile Gerber, drill, BOM, and placement evidence before promotion.
05 ↗PCBoo is an independent MIT-licensed project. It reuses tscircuit’s circuit authoring and compilation ecosystem while adding an agent-first project contract, verification boundaries, local inspection, and production-evidence workflow.
PCBoo is not an official tscircuit product and does not imply endorsement by or affiliation with tscircuit Inc. Third-party packages and assets retain their own licenses.
Read the source on GitHub ↗Follow development, inspect the architecture, and help shape an open circuit workflow made for coding agents.
Star PCBoo on GitHub ↗