app
KiCad - the KiCad Bridge
Public Made by Adomby adom
Reference implementation of the KiCad bridge: multi-instance Python server, forward path via kicad-cli, reverse path via in-process plugin. Most complex of the three bundled bridges.
← Commit history
README.md+14−42@@ -4,6 +4,20 @@ A **reverse bridge** that lets Adom Desktop (AD) — and the AI driving it — c KiCad on Windows: open and drive every editor, install symbol/footprint libraries, place parts, run DRC/ERC, export manufacturing files, and screenshot any window back to the AI. +> ### Two artifacts on this page — which one do you want?+>+> | | **Release ZIP** (`adom-bridge-kicad-v*.zip`) | **Package** (`adom-wiki pkg install adom/adom-desktop-kicad-bridge`) |+> |---|---|---|+> | What it is | The **bridge runtime** — the actual Python server that drives KiCad | **Skills + docs only**, for a container/agent |+> | Who loads it | **Adom Desktop** downloads it automatically via `adom-bridge-kicad-manifest.json` | You, into a container, to teach an agent the `kicad_*` verbs |+> | Contains | code, certs, UIA scripts, board template | `SKILL.md` files (no binaries, no images) |+> | You install it manually? | **No** — AD handles it | Yes |+>+> **The package is not the bridge.** Installing the package does not give you a working+> bridge; AD loading the release zip does. Both are kept deliberately small — the zip is+> auto-bundled into AD, so it ships only what the runtime needs.++ KiCad is the user's **host app**. The bridge *detects* an existing KiCad and, if none is present, *installs* one for them — it never asks the user to download or click through anything by hand. @@ -24,48 +38,6 @@ KiCad is the user's **host app**. The bridge *detects* an existing KiCad and, if⋯ 1 unchanged line ⋯ --## The demo verb — `kicad_demo`--One verb that shows the whole bridge off, built for the AI that demos Adom Desktop-during Hydrogen Desktop's install. Six beats, in the order a hardware person thinks:--| Beat | Shows |-|---|---|-| 1 | the **schematic symbol** in the user's own Symbol Editor |-| 2 | the **footprint** for that same part |-| 3 | that part in **3D** |-| 4 | a **schematic** using it (U1 + two 10k resistors) |-| 5 | the **2D board layout** |-| 6 | the finished **board in 3D** |--```bash-adom-desktop kicad_demo '{}' # start: prepares, warms KiCad, opens beat 1-adom-desktop kicad_demo '{"step":"footprint"}' # ...then follow data.nextCall each time-adom-desktop kicad_demo '{"all":true}' # bulk (non-interactive; slower than one request budget)-adom-desktop kicad_close '{"force":true}' # tear down-```--**It narrates itself.** Every beat returns `say` (a line to speak), `pointOut`-(what's actually on screen), `window` (match it in `kicad_screenshot_all`) and-`nextCall`. One beat per call is the default precisely so the AI can talk, screenshot,-then move on.--**It ships nothing.** The two demo parts, the schematic and the board are all-generated in code, and the 3D bodies come from KiCad's *own* bundled-`3dmodels/*.3dshapes` — so the runtime zip stays small and the 3D views are real.-Parts install into the user's real `Adom` library; the project lands in-`Documents/adom-kicad-demo`.--**No KiCad? It offers to install it.** `kicad_demo` returns an offer instead of an-error; `kicad_demo '{"installKiCad": true}'` silently installs the official build-(per-user, no UAC) and then runs the tour. Watching the AI install your EDA tool is-itself a good demo beat.--**It never takes your screen.** Every window opens in the background and all input is-window-targeted (UIA / `PostMessage`), so you can keep working while it runs.- --- ## How it fits together
package.json+2−4@@ -1,6 +1,6 @@ { "slug": "adom-desktop-kicad-bridge",- "version": "1.0.15",+ "version": "1.0.16", "type": "app", "description": "Skills for your container so your AI knows how to drive the KiCad bridge. The bridge runtime itself is the release zip \u2014 Adom Desktop loads that.", "tags": [@@ -28,8 +28,6 @@ "skills/kicad-interaction/SKILL.md", "skills/kicad-3d-models/SKILL.md", "skills/kicad-tour/SKILL.md",- "skills/kicad-tour/tour_runner.py",- "skills/kicad-tour/hero/README.md",- "skills/kicad-tour/hero/hero_builder.py"+ "skills/kicad-tour/tour_runner.py" ] }
page.json+2−4@@ -4,7 +4,7 @@ "slug": "adom-desktop-kicad-bridge", "title": "Adom Desktop - KiCad Bridge", "brief": "Reference implementation of the KiCad bridge — multi-instance Python server, forward path via kicad-cli, reverse path via in-process plugin. Most complex of the three bundled bridges.",- "version": "1.0.15",+ "version": "1.0.16", "tags": [ "kicad", "pcb",@@ -120,9 +120,7 @@ "skills/kicad-interaction/SKILL.md", "skills/kicad-3d-models/SKILL.md", "skills/kicad-tour/SKILL.md",- "skills/kicad-tour/tour_runner.py",- "skills/kicad-tour/hero/README.md",- "skills/kicad-tour/hero/hero_builder.py"+ "skills/kicad-tour/tour_runner.py" ], "org": "adom" }