# 1. Create a new project
python3 scripts/kicad_pcb.py new "LED Blinker" --description "555 timer LED blinker circuit"# 2. Add components to schematic
python3 scripts/kicad_pcb.py add-component NE555 U1
python3 scripts/kicad_pcb.py add-component LED D1
python3 scripts/kicad_pcb.py add-component "R 1K" R1 R2
# 3. Generate schematic preview (for review)
python3 scripts/kicad_pcb.py preview-schematic
# 4. Run design rule check
python3 scripts/kicad_pcb.py drc
# 5. Export manufacturing files
python3 scripts/kicad_pcb.py export-gerbers
# 6. Prepare PCBWay order
python3 scripts/kicad_pcb.py pcbway-quote --quantity 5
Commands
Project Management
Command
Description
new <name>
Create new KiCad project
open <path>
Open existing project
info
Show current project info
list-projects
List recent projects
Schematic Design
Command
Description
add-component <type> <ref>
Add component to schematic
connect <ref1.pin> <ref2.pin>
Wire components together
add-net <name> <refs...>
Create named net
preview-schematic
Generate schematic image
erc
Run electrical rules check
PCB Layout
Command
Description
import-netlist
Import schematic to PCB
auto-place
Auto-place components
auto-route
Auto-route traces
set-board-size <W>x<H>
Set board dimensions (mm)
preview-pcb
Generate PCB preview images
drc
Run design rules check
Manufacturing Export
Command
Description
export-gerbers
Export Gerber files
export-drill
Export drill files
export-bom
Export bill of materials
export-pos
Export pick-and-place file
export-3d
Export 3D model (STEP/GLB)
package-for-fab
Create ZIP with all files
PCBWay Integration
Command
Description
pcbway-quote
Get instant quote
pcbway-upload
Upload Gerbers to PCBWay
pcbway-cart
Add to cart (requires auth)
Workflow: Natural Language to PCB
Step 1: Describe Your Circuit
Tell me what you want to build:
"I need a simple 555 timer circuit that blinks an LED at about 1Hz.
Should run on 9V battery, through-hole components for easy soldering."
Step 2: I'll Generate the Design
# Create project
kicad_pcb.py new "LED_Blinker_555"# Add components based on description
kicad_pcb.py from-description "555 timer LED blinker, 1Hz, 9V battery"