KiCad - the KiCad Bridge

{
  "dock_manifest": "1.2.0",
  "say": [
    "open the XL555 symbol from wiki part ray/xl555 in kicad",
    "send the footprint of ray/xl555 to kicad",
    "show me adom/drone-motor-carrier in kicad 3d",
    "open the wiki project adom/esc-g431 in kicad",
    "install the Adom Basic Parts library into kicad",
    "export gerbers for adom/carrier-fc-rp2350a-mini from kicad"
  ],
  "webview": {
    "title": "KiCad Dashboard",
    "favicon": "docs/img/dock-kicad.svg"
  },
  "health": {
    "url": "/api/status",
    "poll_seconds": 15,
    "timeout_ms": 2000
  },
  "launch": {
    "mode": "container_command",
    "console": "show",
    "steps": [
      {
        "label": "Installing or updating the KiCad bridge",
        "run": "sh -c 'PATH=\"$HOME/.local/bin:$PATH\"; adom-wiki pkg update kicad-bridge || adom-wiki pkg install adom/kicad-bridge; command -v kicad-dashboard >/dev/null 2>&1 || { adom-wiki pkg uninstall adom/kicad-bridge; adom-wiki pkg install adom/kicad-bridge; }'",
        "timeout_seconds": 180
      },
      {
        "label": "Starting the KiCad Dashboard",
        "run": "sh -c 'PATH=\"$HOME/.local/bin:$PATH\"; exec kicad-dashboard serve --print-url'",
        "await": "url",
        "timeout_seconds": 60
      }
    ],
    "on_ready": "navigate_placeholder",
    "ai": {
      "prompt": "The user just opened the KiCad Dashboard from the dock. It shows LED status for every KiCad bridge facet. If any LED is not green, offer to fix it (the /api/status payload carries a _hint per LED naming the exact verb). Everything the bridge does to KiCad happens in the background; never steal their foreground, and never touch a KiCad instance the user launched themselves.",
      "thread": "existing",
      "thread_fallback": "new",
      "submit": "staged",
      "typed": false
    }
  }
}