Skip to content
tangency-labsPublic

About

Electronics design that feels like KiCad, built for people and agents to work on the same board

Resources

Contributing

Stars

139 stars

Watchers

3 watching

Forks

Repository files navigation

PCBCraft

Open-source electronics design for people and AI agents.
Draw schematics, edit PCB layouts and work alongside an agent in the same editor,
with shared commands and undo history. Built in Rust for desktop and browser.

Quickstart · Documentation · Capabilities · Contributing · Vision

CI Status: early development License: MIT OR Apache-2.0

What works

PCBCraft is in early development, with schematic and PCB editing on desktop and in the browser. You can draw a circuit, assign footprints, review changes before applying them to the board, place and edit copper tracks and through vias, and save the schematic and board together with shared undo/redo.

  • Schematics: place and edit symbols, draw and reshape orthogonal wires, move or grab groups, mark unused pins and wire ends, name nets with local/global labels and power/ground symbols, and organize flat or hierarchical sheets.
  • PCB layout: assign pinned footprints, review package and connection changes before applying them, draw a Board Outline, move/rotate/flip footprints, and place, move and resize tracks and through vias, and route around fixed copper. Layer controls, net highlighting and schematic/PCB component highlights help navigate the board; see the layout guide.
  • Checks: review DRC findings for shorts, copper clearance, track width, via annular rings, unrouted connections, board edges and courtyard overlap, using saved board rules and supported dimensional net-class rules.
  • Outputs: export supported board geometry as Gerber X2 copper, mask, paste, silkscreen and outline layers with aperture functions, plus net and pin attributes on copper. Circular plated holes are included as an Excellon drill file in the same archive.
  • Views: work with schematic and PCB panes side by side, or use multiple desktop windows with independent cameras and a shared project session.
  • Libraries: browse built-in, project-pinned and registered native libraries in Parts Library. Place generic or orderable parts, choose packages and assign footprints. Author symbols and footprints in their own workspaces, then publish revisions to writable native folders on desktop.
  • Projects: save a Git-friendly project folder or share a .pc archive. Pinned symbol and footprint definitions travel with the project. The CLI can explicitly convert the previous split layout into a new copy.
  • AI tools: use the desktop Assistant with an installed agent or model endpoint, connect an MCP client to the open editor, or run a headless session.

Full ERC, broader DRC coverage, advanced routing, copper-zone fill and 3D/STEP workflows remain in development. Footprint slots, separate non-plated drill output and independent footprint mask/paste controls are not yet supported. The current checks and exporters do not establish manufacturing readiness.

The capability table separates available features from remaining work. The MVP milestone tracks the first collaboration-ready preview; VISION.md explains the longer-term direction, including familiar KiCad controls and links with SolidCraft.

Get started

Use Rust 1.95 or later. From the repository root, build the desktop app and its companion CLI, then launch the editor:

cargo build --locked -p pcbcraft -p pcbcraft-cli
cargo run --locked -p pcbcraft

The quickstart covers opening a project, schematic editing and saving, with PCB tools described in the editor guide. The sensor node example includes a small MCU, an I²C sensor, status LEDs and a routed board; a transistor flasher is available as a second demo. Both have shareable archives.

Run the browser app locally

Install the WebAssembly target and Trunk, then serve the app:

rustup target add wasm32-unknown-unknown
cargo install --locked trunk --version 0.21.14
cd apps/pcbcraft-web
trunk serve --locked

Open localhost:8781. The browser uploads projects and downloads .pc archives; the Assistant and live MCP connection are desktop features. Build prerequisites and troubleshooting are in CONTRIBUTING.md.

AI assistants and MCP

Open Assistant beside Preferences in the desktop app to connect an installed coding agent or a compatible model endpoint. Edits run through the editor's commands, appear on the canvas and share its undo history.

For an external MCP client, choose Help (?) → Connect AI assistants… → Enable local connection and copy the configuration. For a separate headless session:

cargo run --locked -p pcbcraft-cli -- mcp

Native live MCP also supports UI automation: locate named controls and send clicks, drags, keys, text and scrolling through ordinary editor input. Input currently targets the original native window and its split panes; headless sessions operate separately from the open editor.

The AI and MCP guide covers agent setup, permissions, live connections and command examples.

Documentation

The documentation map groups user guides, implementation references, architecture plans and verification records, with reading paths for contributors and agents.

Guide Contents
Quickstart · Example project First editing session
Editor guide Tools, shortcuts, wiring, views and project files
Capabilities Current support, limits and planned work
AI assistants and MCP · UI automation Agent connections, shared commands and native UI input
Contributing · Agent instructions Repository workflow, architecture and checks
Reference and formats Project storage, library schemas, nets, rules and shared geometry

Contributing

CONTRIBUTING.md covers the build, code map, required checks and source rules. Find a bounded task in GitHub issues, check for existing claims and open PRs, and leave a claimed comment on the issue before starting. The first claimant gets merge priority under the issue claim policy.

PCBCraft is an independent application in the Craft family. Development follows the clean-room contribution rules: published specifications and black-box observations are permitted; KiCad and other GPL EDA implementation sources are excluded.

License

MIT OR Apache-2.0, at your option. See LICENSE-MIT, LICENSE-APACHE and ATTRIBUTION.md for the project licenses and third-party notices. Library data, fonts and other assets retain their documented licenses.

About

Electronics design that feels like KiCad, built for people and agents to work on the same board

Resources

Contributing

Stars

139 stars

Watchers

3 watching

Forks

Releases

Packages

Contributors

Languages