← Commit history

Initial commit: app/kicad-pcb-viewer

Kyle Bergstedt ·dbb0038911 ·
2 files changed +355
README.mdadded+279
@@ -0,0 +1,279 @@+A 2D PCB viewer for `.kicad_pcb` files, rendered as SVG inside a Hydrogen+webview panel. For when you want to **see** a board without launching+KiCad on the user's desktop.++![BMA400 breakout — front view with copper, silk, and edge cuts](apps/kicad-pcb-viewer/hero.png)++## Why this exists++Adom already has 3D viewers (`.glb` chip models) and gerber viewers+(post-fab artwork). What was missing was the in-between: the editable+KiCad board, viewed flat, with toggleable layers, in the cloud editor.++This app is deliberately 2D — for 3D inspection, use the existing 3D+viewers. Use this when:++- The user pasted a `.kicad_pcb` and you want to confirm it looks sane+  before doing anything else with it.+- You're debugging a board layout and want to see "did the autorouter+  stack everything on F.Cu? Where are the vias?"+- You want to take a layer-isolated screenshot (e.g. board outline only)+  to drop into a doc, a PR, or a chat message.+- You want to verify silkscreen orientation, or check what's actually+  on the back side of a board, without firing up pcbnew.++## Install++```bash+gh release download v0.1.0 --repo adom-inc/kicad-pcb-viewer \+    --pattern kicad-pcb-viewer-linux \+    -D /tmp+sudo install -m 0755 /tmp/kicad-pcb-viewer-linux /usr/local/bin/kicad-pcb-viewer+kicad-pcb-viewer install   # deploys SKILL.md to ~/.claude/skills/kicad-pcb-viewer/+```++Runs on any Python 3.10+ system. No external dependencies — just stdlib.++## Quick start (human-driven)++```bash+kicad-pcb-viewer view path/to/board.kicad_pcb+```++Opens a Hydrogen webview tab in a non-VSCode pane (per `app-creator`+skill — never inside the editor pane).++| Action | Input |+|---|---|+| Pan | Click + drag |+| Zoom | Scroll wheel (toward cursor) |+| Reset to fit | `Fit` button |+| Mirror horizontally | `Flip` button |+| Toggle layer | Click a row in the sidebar |++Coordinate readout (mm) and zoom % live in the bottom-right HUD.++## CLI subcommands++| Command | What it does |+|---|---|+| `view <path> [--port N]` | Start server + open webview tab. Default. |+| `serve <path> [--port N]` | Start server only (no tab). Useful for headless scripting. |+| `shutdown [--port N]` | Stop a running viewer (graceful). |+| `install` | Deploy `SKILL.md` to `~/.claude/skills/kicad-pcb-viewer/`. |+| `version` | Print version. |++Default port: `9100`. The first positional arg is auto-inferred as `view`+if it ends in `.kicad_pcb` or is an existing path, so+`kicad-pcb-viewer board.kicad_pcb` works as shorthand.++## Multi-layer boards++Inner copper layers (`In1.Cu`, `In2.Cu`, `In3.Cu`, `In4.Cu`) get distinct+colors and z-order. The layer panel only lists layers that **actually+have geometry on this board** — empty layers stay hidden, so the panel+doesn't fill up with 30 unused entries.++![BMI270 — 4-layer board with copper pours, inner layers, vias](apps/kicad-pcb-viewer/multilayer.png)++## HTTP API — every action is AI-drivable++Per `app-creator` §7, the same endpoints the UI uses are reachable via+HTTP. This is the property that turns a webview into an AI surface.++| Method | Path | Description |+|---|---|---|+| GET | `/state` | Phase, file path, filename, stats, bbox, layer visibility. |+| GET | `/board` | Full parsed board JSON (footprints, pads, segments, arcs, vias, zones, gr). |+| GET | `/layers` | `{name: {idx, kind, alias, visible}}` for every layer on the board. |+| POST | `/layers` | Body `{name: bool, ...}` — set visibility for one or more layers. |+| POST | `/load` | Body `{path: "..."}` — open a different `.kicad_pcb` without restarting the server. |+| POST | `/fit` | Reset view to fit the board. |+| POST | `/flip` | Toggle horizontal mirror (B-side viewing). Returns `{flipped: bool}`. |+| GET | `/console` | Last 500 forwarded UI-side console messages. |+| POST | `/console` | Append a message (called from the UI). |+| DELETE | `/console` | Clear log. |+| POST | `/eval` | Body `{code: "..."}` — queue a JS snippet, returns `{id}`. UI runs it on next poll. |+| GET | `/eval/pending` | UI poller endpoint — returns `{id, code}` or empty. |+| GET | `/eval/<id>` | Read result of a prior `/eval` post. |+| POST | `/eval/<id>/result` | UI POSTs result back here (internal). |+| POST | `/shutdown` | Graceful exit. |+| GET | `/cmds/pending` | UI poller for fit/flip commands queued by `/fit` and `/flip`. |+| GET | `/` | The UI HTML. |+| GET | `/favicon.svg` | Brand icon. |++## AI recipes++Self-contained scripts an AI can copy-paste. All assume the viewer is+running on port `9100` against some board.++### Recipe 1 — "is this board mostly empty?"++Quick stats check before doing anything else.++```bash+kicad-pcb-viewer serve board.kicad_pcb --port 9100 &+sleep 1+curl -s http://127.0.0.1:9100/state | jq '.stats, .bbox'+# {"footprints":13,"pads":31,"segments":61,"arcs":0,"vias":6,"zones":0,"gr":16}+# {"x":18.8,"y":18.8,"w":10.4,"h":10.4}+curl -s -X POST http://127.0.0.1:9100/shutdown >/dev/null+```++### Recipe 2 — "isolate Edge.Cuts and screenshot"++For a board-outline export. Hide every layer except the edge.++```bash+curl -X POST http://127.0.0.1:9100/layers \+    -H 'Content-Type: application/json' \+    -d '{+      "F.Cu":false,"B.Cu":false,+      "In1.Cu":false,"In2.Cu":false,"In3.Cu":false,"In4.Cu":false,+      "F.SilkS":false,"B.SilkS":false,+      "F.Mask":false,"B.Mask":false,+      "F.Paste":false,"B.Paste":false,+      "F.Fab":false,"B.Fab":false,+      "F.CrtYd":false,"B.CrtYd":false,+      "Edge.Cuts":true+    }'+adom-cli hydrogen screenshot panel --name "PCB: <filename>"+```++### Recipe 3 — "show only the back side"++Hide front-side layers, flip the view, screenshot.++```bash+curl -X POST http://127.0.0.1:9100/layers -H 'Content-Type: application/json' \+    -d '{"F.Cu":false,"F.SilkS":false,"F.Mask":false,"F.Paste":false,"F.Fab":false,"F.CrtYd":false,+         "B.Cu":true,"B.SilkS":true,"Edge.Cuts":true}'+curl -X POST http://127.0.0.1:9100/flip+adom-cli hydrogen screenshot panel --name "PCB: <filename>"+```++### Recipe 4 — "list every footprint and its placement"++Useful for cross-referencing with a BOM or schematic.++```bash+curl -s http://127.0.0.1:9100/board | \+    jq '.footprints[] | {refdes, value, x, y, rot, layer}'+# {"refdes":"U1","value":"BMA400","x":24.0,"y":24.0,"rot":0,"layer":"F.Cu"}+# ...+```++### Recipe 5 — "diff two boards by stats"++```bash+for f in v1.kicad_pcb v2.kicad_pcb; do+    curl -s -X POST http://127.0.0.1:9100/load \+        -H 'Content-Type: application/json' -d "{\"path\":\"$PWD/$f\"}" >/dev/null+    echo "=== $f ==="+    curl -s http://127.0.0.1:9100/state | jq '.stats'+done+```++### Recipe 6 — "swap to a new board without restarting"++The same server can host any board. POST `/load` to swap without+opening a new tab.++```bash+curl -X POST http://127.0.0.1:9100/load \+    -H 'Content-Type: application/json' \+    -d '{"path":"/home/adom/project/foo/foo.kicad_pcb"}'+adom-cli hydrogen webview refresh --name "PCB: <old-filename>"+```++(The tab name keeps the original board's filename — a future version can+update the title on `/load`.)++### Recipe 7 — "inspect the rendered DOM via /eval"++Need to know what's actually visible? Eval a snippet inside the page.++```bash+curl -X POST http://127.0.0.1:9100/eval \+    -H 'Content-Type: application/json' \+    -d '{"code":"return Array.from(document.querySelectorAll(\".layer-group\")).map(g => ({layer: g.dataset.layer, hidden: g.classList.contains(\"hidden\"), elements: g.children.length}))"}'+# {"id":"a1b2c3"}++# Read result via /console (the UI logs results)+curl -s http://127.0.0.1:9100/console | jq '.messages[-1]'+```++### Recipe 8 — "headless render-to-screenshot pipeline"++Combine `serve`, layer toggles, and `adom-cli hydrogen screenshot` to+build per-layer images for a doc:++```bash+kicad-pcb-viewer view board.kicad_pcb --port 9100 &+sleep 2+for layer in F.Cu B.Cu F.SilkS Edge.Cuts; do+    # Hide everything except this layer + Edge.Cuts (always nice to see outline)+    body=$(jq -nc --arg L "$layer" '+        {"F.Cu":false,"B.Cu":false,"In1.Cu":false,"In2.Cu":false,+         "F.SilkS":false,"B.SilkS":false,"F.Mask":false,"B.Mask":false,+         "F.Paste":false,"B.Paste":false,"F.Fab":false,"B.Fab":false,+         "F.CrtYd":false,"B.CrtYd":false,"Edge.Cuts":true} |+        .[$L] = true')+    curl -s -X POST http://127.0.0.1:9100/layers -H 'Content-Type: application/json' -d "$body" >/dev/null+    sleep 0.5+    adom-cli hydrogen screenshot panel --name "PCB: $(basename board.kicad_pcb)"+done+```++## What it parses++- `(footprint …)` — placement (`at`), rotation, child pads + graphics+- `(pad …)` — `rect`, `roundrect`, `circle`, `oval`, with drill (round or+  oval slot), through-hole and SMD+- `(segment …)`, `(arc …)` — copper traces with width+- `(via …)` — size + drill+- `(zone …)` — filled polygons (post-fill state preferred, falls back to+  outline if `filled_polygon` not present)+- `(gr_line/arc/circle/rect/poly …)` — top-level graphics on any layer+- `(fp_line/arc/circle/rect/poly …)` — footprint-level graphics (silk,+  fab, courtyard)+- `(layers …)` — layer table with index, kind, alias+- Pad-side `(layers …)` lists with `*.Cu` / `*.Mask` / `*.Paste` wildcards+  expanded to the matching concrete layers++## What it doesn't (yet)++- Schematic (`.kicad_sch`) rendering — different format, different scope.+- Net highlighting / cross-probing.+- File watching — call `POST /load` to reload after edits.+- Refdes / value labels overlaid on the board (too cluttered at default+  zoom; could be added as a togglable text overlay layer).+- Bezier curves on `gr_curve` — currently approximated as polylines.++## Pane placement (important)++The viewer ALWAYS opens in a pane that is NOT the VSCode pane. If a+non-VSCode pane already exists, the tab joins it; otherwise the VSCode+pane is split vertically and the tab lands in the new pane.++This rule lives in `skills/app-creator` §4 — it applies to every Adom+app, not just this one. Putting webviews as sibling tabs inside the+VSCode pane covers the editor and is wrong.++## Files in this repo++```+bin/kicad-pcb-viewer    # Python CLI (subcommands: view, serve, install, shutdown, version)+src/parser.py           # s-expression tokenizer + per-layer extractor+src/server.py           # HTTP server, all endpoints, asset loading (source + zipapp)+src/ui.html             # SVG renderer, pan/zoom, layer panel, console fwd, eval poller+docs/icon.svg           # Brand-teal favicon (also the tab icon)+docs/SKILL.md           # AI usage doc deployed by `kicad-pcb-viewer install`+samples/                # BMA400 + BMI270 reference boards (from adom-inc/bosch-molecules)+scripts/build.sh        # Builds dist/kicad-pcb-viewer-linux zipapp (~22 KB)+```++## Repo++[`adom-inc/kicad-pcb-viewer`](https://github.com/adom-inc/kicad-pcb-viewer) — private. Releases attach a single-file+zipapp (`kicad-pcb-viewer-linux`).
page.jsonadded+76
@@ -0,0 +1,76 @@+{+  "schema_version": 1,+  "type": "app",+  "slug": "kicad-pcb-viewer",+  "title": "kicad-pcb-viewer — 2D viewer for .kicad_pcb files",+  "brief": "2D PCB viewer for .kicad_pcb files in a Hydrogen webview. Pan, zoom, toggle layers, flip to inspect the back side. Stdlib Python, ~22 KB binary.",+  "version": "0.1.0",+  "tags": [],+  "license": "MIT",+  "discovery_triggers": [+    "view kicad pcb",+    "view .kicad_pcb",+    "open .kicad_pcb",+    "preview pcb",+    "show me the board",+    "what does this pcb look like",+    "render the board",+    "render kicad board",+    "pcb viewer",+    "2d pcb viewer",+    "inspect pcb",+    "inspect board layers",+    "view board layers",+    "toggle pcb layer",+    "show pcb silk",+    "show f.cu",+    "show b.cu",+    "flip pcb",+    "back side of board",+    "pcb without kicad",+    "kicad-pcb-viewer"+  ],+  "discovery_pitch": "Open a .kicad_pcb in a Hydrogen webview — flat 2D render, layer toggles, pan/zoom — without launching KiCad on the desktop.",+  "sample_prompts": [+    {+      "label": "View",+      "prompt": "Open this .kicad_pcb in a viewer"+    },+    {+      "label": "Layers",+      "prompt": "Show only Edge.Cuts and F.SilkS on this board"+    },+    {+      "label": "Flip",+      "prompt": "Flip the board so I can see the back side"+    },+    {+      "label": "Stats",+      "prompt": "How many footprints, traces, and vias does this board have?"+    },+    {+      "label": "Footprints",+      "prompt": "List every footprint on this board with its placement"+    }+  ],+  "install": {+    "binary_name": "kicad-pcb-viewer",+    "install_dir": "",+    "install_hint": "",+    "version_cmd": ""+  },+  "readme": "A 2D PCB viewer for `.kicad_pcb` files, rendered as SVG inside a Hydrogen\nwebview panel. For when you want to **see** a board without launching\nKiCad on the user's desktop.\n\n![BMA400 breakout — front view with copper, silk, and edge cuts](apps/kicad-pcb-viewer/hero.png)\n\n## Why this exists\n\nAdom already has 3D viewers (`.glb` chip models) and gerber viewers\n(post-fab artwork). What was missing was the in-between: the editable\nKiCad board, viewed flat, with toggleable layers, in the cloud editor.\n\nThis app is deliberately 2D — for 3D inspection, use the existing 3D\nviewers. Use this when:\n\n- The user pasted a `.kicad_pcb` and you want to confirm it looks sane\n  before doing anything else with it.\n- You're debugging a board layout and want to see \"did the autorouter\n  stack everything on F.Cu? Where are the vias?\"\n- You want to take a layer-isolated screenshot (e.g. board outline only)\n  to drop into a doc, a PR, or a chat message.\n- You want to verify silkscreen orientation, or check what's actually\n  on the back side of a board, without firing up pcbnew.\n\n## Install\n\n```bash\ngh release download v0.1.0 --repo adom-inc/kicad-pcb-viewer \\\n    --pattern kicad-pcb-viewer-linux \\\n    -D /tmp\nsudo install -m 0755 /tmp/kicad-pcb-viewer-linux /usr/local/bin/kicad-pcb-viewer\nkicad-pcb-viewer install   # deploys SKILL.md to ~/.claude/skills/kicad-pcb-viewer/\n```\n\nRuns on any Python 3.10+ system. No external dependencies — just stdlib.\n\n## Quick start (human-driven)\n\n```bash\nkicad-pcb-viewer view path/to/board.kicad_pcb\n```\n\nOpens a Hydrogen webview tab in a non-VSCode pane (per `app-creator`\nskill — never inside the editor pane).\n\n| Action | Input |\n|---|---|\n| Pan | Click + drag |\n| Zoom | Scroll wheel (toward cursor) |\n| Reset to fit | `Fit` button |\n| Mirror horizontally | `Flip` button |\n| Toggle layer | Click a row in the sidebar |\n\nCoordinate readout (mm) and zoom % live in the bottom-right HUD.\n\n## CLI subcommands\n\n| Command | What it does |\n|---|---|\n| `view <path> [--port N]` | Start server + open webview tab. Default. |\n| `serve <path> [--port N]` | Start server only (no tab). Useful for headless scripting. |\n| `shutdown [--port N]` | Stop a running viewer (graceful). |\n| `install` | Deploy `SKILL.md` to `~/.claude/skills/kicad-pcb-viewer/`. |\n| `version` | Print version. |\n\nDefault port: `9100`. The first positional arg is auto-inferred as `view`\nif it ends in `.kicad_pcb` or is an existing path, so\n`kicad-pcb-viewer board.kicad_pcb` works as shorthand.\n\n## Multi-layer boards\n\nInner copper layers (`In1.Cu`, `In2.Cu`, `In3.Cu`, `In4.Cu`) get distinct\ncolors and z-order. The layer panel only lists layers that **actually\nhave geometry on this board** — empty layers stay hidden, so the panel\ndoesn't fill up with 30 unused entries.\n\n![BMI270 — 4-layer board with copper pours, inner layers, vias](apps/kicad-pcb-viewer/multilayer.png)\n\n## HTTP API — every action is AI-drivable\n\nPer `app-creator` §7, the same endpoints the UI uses are reachable via\nHTTP. This is the property that turns a webview into an AI surface.\n\n| Method | Path | Description |\n|---|---|---|\n| GET | `/state` | Phase, file path, filename, stats, bbox, layer visibility. |\n| GET | `/board` | Full parsed board JSON (footprints, pads, segments, arcs, vias, zones, gr). |\n| GET | `/layers` | `{name: {idx, kind, alias, visible}}` for every layer on the board. |\n| POST | `/layers` | Body `{name: bool, ...}` — set visibility for one or more layers. |\n| POST | `/load` | Body `{path: \"...\"}` — open a different `.kicad_pcb` without restarting the server. |\n| POST | `/fit` | Reset view to fit the board. |\n| POST | `/flip` | Toggle horizontal mirror (B-side viewing). Returns `{flipped: bool}`. |\n| GET | `/console` | Last 500 forwarded UI-side console messages. |\n| POST | `/console` | Append a message (called from the UI). |\n| DELETE | `/console` | Clear log. |\n| POST | `/eval` | Body `{code: \"...\"}` — queue a JS snippet, returns `{id}`. UI runs it on next poll. |\n| GET | `/eval/pending` | UI poller endpoint — returns `{id, code}` or empty. |\n| GET | `/eval/<id>` | Read result of a prior `/eval` post. |\n| POST | `/eval/<id>/result` | UI POSTs result back here (internal). |\n| POST | `/shutdown` | Graceful exit. |\n| GET | `/cmds/pending` | UI poller for fit/flip commands queued by `/fit` and `/flip`. |\n| GET | `/` | The UI HTML. |\n| GET | `/favicon.svg` | Brand icon. |\n\n## AI recipes\n\nSelf-contained scripts an AI can copy-paste. All assume the viewer is\nrunning on port `9100` against some board.\n\n### Recipe 1 — \"is this board mostly empty?\"\n\nQuick stats check before doing anything else.\n\n```bash\nkicad-pcb-viewer serve board.kicad_pcb --port 9100 &\nsleep 1\ncurl -s http://127.0.0.1:9100/state | jq '.stats, .bbox'\n# {\"footprints\":13,\"pads\":31,\"segments\":61,\"arcs\":0,\"vias\":6,\"zones\":0,\"gr\":16}\n# {\"x\":18.8,\"y\":18.8,\"w\":10.4,\"h\":10.4}\ncurl -s -X POST http://127.0.0.1:9100/shutdown >/dev/null\n```\n\n### Recipe 2 — \"isolate Edge.Cuts and screenshot\"\n\nFor a board-outline export. Hide every layer except the edge.\n\n```bash\ncurl -X POST http://127.0.0.1:9100/layers \\\n    -H 'Content-Type: application/json' \\\n    -d '{\n      \"F.Cu\":false,\"B.Cu\":false,\n      \"In1.Cu\":false,\"In2.Cu\":false,\"In3.Cu\":false,\"In4.Cu\":false,\n      \"F.SilkS\":false,\"B.SilkS\":false,\n      \"F.Mask\":false,\"B.Mask\":false,\n      \"F.Paste\":false,\"B.Paste\":false,\n      \"F.Fab\":false,\"B.Fab\":false,\n      \"F.CrtYd\":false,\"B.CrtYd\":false,\n      \"Edge.Cuts\":true\n    }'\nadom-cli hydrogen screenshot panel --name \"PCB: <filename>\"\n```\n\n### Recipe 3 — \"show only the back side\"\n\nHide front-side layers, flip the view, screenshot.\n\n```bash\ncurl -X POST http://127.0.0.1:9100/layers -H 'Content-Type: application/json' \\\n    -d '{\"F.Cu\":false,\"F.SilkS\":false,\"F.Mask\":false,\"F.Paste\":false,\"F.Fab\":false,\"F.CrtYd\":false,\n         \"B.Cu\":true,\"B.SilkS\":true,\"Edge.Cuts\":true}'\ncurl -X POST http://127.0.0.1:9100/flip\nadom-cli hydrogen screenshot panel --name \"PCB: <filename>\"\n```\n\n### Recipe 4 — \"list every footprint and its placement\"\n\nUseful for cross-referencing with a BOM or schematic.\n\n```bash\ncurl -s http://127.0.0.1:9100/board | \\\n    jq '.footprints[] | {refdes, value, x, y, rot, layer}'\n# {\"refdes\":\"U1\",\"value\":\"BMA400\",\"x\":24.0,\"y\":24.0,\"rot\":0,\"layer\":\"F.Cu\"}\n# ...\n```\n\n### Recipe 5 — \"diff two boards by stats\"\n\n```bash\nfor f in v1.kicad_pcb v2.kicad_pcb; do\n    curl -s -X POST http://127.0.0.1:9100/load \\\n        -H 'Content-Type: application/json' -d \"{\\\"path\\\":\\\"$PWD/$f\\\"}\" >/dev/null\n    echo \"=== $f ===\"\n    curl -s http://127.0.0.1:9100/state | jq '.stats'\ndone\n```\n\n### Recipe 6 — \"swap to a new board without restarting\"\n\nThe same server can host any board. POST `/load` to swap without\nopening a new tab.\n\n```bash\ncurl -X POST http://127.0.0.1:9100/load \\\n    -H 'Content-Type: application/json' \\\n    -d '{\"path\":\"/home/adom/project/foo/foo.kicad_pcb\"}'\nadom-cli hydrogen webview refresh --name \"PCB: <old-filename>\"\n```\n\n(The tab name keeps the original board's filename — a future version can\nupdate the title on `/load`.)\n\n### Recipe 7 — \"inspect the rendered DOM via /eval\"\n\nNeed to know what's actually visible? Eval a snippet inside the page.\n\n```bash\ncurl -X POST http://127.0.0.1:9100/eval \\\n    -H 'Content-Type: application/json' \\\n    -d '{\"code\":\"return Array.from(document.querySelectorAll(\\\".layer-group\\\")).map(g => ({layer: g.dataset.layer, hidden: g.classList.contains(\\\"hidden\\\"), elements: g.children.length}))\"}'\n# {\"id\":\"a1b2c3\"}\n\n# Read result via /console (the UI logs results)\ncurl -s http://127.0.0.1:9100/console | jq '.messages[-1]'\n```\n\n### Recipe 8 — \"headless render-to-screenshot pipeline\"\n\nCombine `serve`, layer toggles, and `adom-cli hydrogen screenshot` to\nbuild per-layer images for a doc:\n\n```bash\nkicad-pcb-viewer view board.kicad_pcb --port 9100 &\nsleep 2\nfor layer in F.Cu B.Cu F.SilkS Edge.Cuts; do\n    # Hide everything except this layer + Edge.Cuts (always nice to see outline)\n    body=$(jq -nc --arg L \"$layer\" '\n        {\"F.Cu\":false,\"B.Cu\":false,\"In1.Cu\":false,\"In2.Cu\":false,\n         \"F.SilkS\":false,\"B.SilkS\":false,\"F.Mask\":false,\"B.Mask\":false,\n         \"F.Paste\":false,\"B.Paste\":false,\"F.Fab\":false,\"B.Fab\":false,\n         \"F.CrtYd\":false,\"B.CrtYd\":false,\"Edge.Cuts\":true} |\n        .[$L] = true')\n    curl -s -X POST http://127.0.0.1:9100/layers -H 'Content-Type: application/json' -d \"$body\" >/dev/null\n    sleep 0.5\n    adom-cli hydrogen screenshot panel --name \"PCB: $(basename board.kicad_pcb)\"\ndone\n```\n\n## What it parses\n\n- `(footprint …)` — placement (`at`), rotation, child pads + graphics\n- `(pad …)` — `rect`, `roundrect`, `circle`, `oval`, with drill (round or\n  oval slot), through-hole and SMD\n- `(segment …)`, `(arc …)` — copper traces with width\n- `(via …)` — size + drill\n- `(zone …)` — filled polygons (post-fill state preferred, falls back to\n  outline if `filled_polygon` not present)\n- `(gr_line/arc/circle/rect/poly …)` — top-level graphics on any layer\n- `(fp_line/arc/circle/rect/poly …)` — footprint-level graphics (silk,\n  fab, courtyard)\n- `(layers …)` — layer table with index, kind, alias\n- Pad-side `(layers …)` lists with `*.Cu` / `*.Mask` / `*.Paste` wildcards\n  expanded to the matching concrete layers\n\n## What it doesn't (yet)\n\n- Schematic (`.kicad_sch`) rendering — different format, different scope.\n- Net highlighting / cross-probing.\n- File watching — call `POST /load` to reload after edits.\n- Refdes / value labels overlaid on the board (too cluttered at default\n  zoom; could be added as a togglable text overlay layer).\n- Bezier curves on `gr_curve` — currently approximated as polylines.\n\n## Pane placement (important)\n\nThe viewer ALWAYS opens in a pane that is NOT the VSCode pane. If a\nnon-VSCode pane already exists, the tab joins it; otherwise the VSCode\npane is split vertically and the tab lands in the new pane.\n\nThis rule lives in `skills/app-creator` §4 — it applies to every Adom\napp, not just this one. Putting webviews as sibling tabs inside the\nVSCode pane covers the editor and is wrong.\n\n## Files in this repo\n\n```\nbin/kicad-pcb-viewer    # Python CLI (subcommands: view, serve, install, shutdown, version)\nsrc/parser.py           # s-expression tokenizer + per-layer extractor\nsrc/server.py           # HTTP server, all endpoints, asset loading (source + zipapp)\nsrc/ui.html             # SVG renderer, pan/zoom, layer panel, console fwd, eval poller\ndocs/icon.svg           # Brand-teal favicon (also the tab icon)\ndocs/SKILL.md           # AI usage doc deployed by `kicad-pcb-viewer install`\nsamples/                # BMA400 + BMI270 reference boards (from adom-inc/bosch-molecules)\nscripts/build.sh        # Builds dist/kicad-pcb-viewer-linux zipapp (~22 KB)\n```\n\n## Repo\n\n[`adom-inc/kicad-pcb-viewer`](https://github.com/adom-inc/kicad-pcb-viewer) — private. Releases attach a single-file\nzipapp (`kicad-pcb-viewer-linux`).\n",+  "author": {+    "id": "695820315b5f1e4db2fcf602",+    "name": "Kyle Bergstedt",+    "email": "[email protected]"+  },+  "visibility": {+    "public": true+  },+  "hero": null,+  "metadata": {},+  "created_at": "2026-05-28T05:29:14.006Z",+  "updated_at": "2026-05-28T05:29:14.006Z",+  "skills": []+}\ No newline at end of file