bootstrap

ntx-octolux-toolkit

Public Approved by Adom

by Caleb

NTX Octolux toolkit — installs the Web Serial HMI + USB CDC firmware pattern and the Octolux app server debug skill together. One command bootstraps an NTX container for building and debugging Octolux

Overview Files Packages Releases Dependencies Issues Breadcrumbs Pull Requests Activity
bootstrap / ntx-octolux-toolkit

Bootstrap with one command

Latest: v0.1.0, published

Fresh container (no adom-wiki yet):

bash <(curl -fsSL https://wiki.adom.inc/static/bootstrap.sh) caleb/ntx-octolux-toolkit

Already have adom-wiki installed:

adom-wiki pkg install caleb/ntx-octolux-toolkit

What you'll get 2 skills

skill octolux-app-server-debug ^0.1.0

Diagnose any Octolux Node.js app server failure that breaks the Dashboard (startup or runtime). Six symptoms with root causes and fixes.
skill octolux-web-serial-hmi ^0.1.0

Build a paired NTX HMI (Chromium kiosk on Octolux) + firmware (USB CDC on RP2040/RP2350) that auto-connects over USB with no permission picker. End-to-end recipe: Pico SDK firmware template, HMI Web Serial via getPorts() + VID filter, Chromium SerialAllowAllPortsForUrls policy, udev MODE=0666 for /dev/ttyACM*, SCP + chromium-restart + screencast-bounce deploy, CDP verification, visible-debug-strip diagnostics, and a 12-row failure-mode table.

ntx-octolux-toolkit

One-shot install of the NTX Octolux skill bundle.

adompkg install ntx-octolux-toolkit

This pulls down both:

  • octolux-app-server-debug — Diagnose Octolux Node.js app server failures (six symptoms, root causes, fixes). Covers ECONNREFUSED, missing-ws-npm-dep, EADDRINUSE, blank-dashboard, section-button bugs, Hydrogen 409s, and the Adom HTTPS proxy 5xx-body-stripping gotcha.
  • octolux-web-serial-hmi — Build a paired NTX HMI (Chromium kiosk on Octolux) + firmware (USB CDC on RP2040 / RP2350) that auto-connects over USB with no permission picker. End-to-end recipe with Chromium policy, udev rule, deploy + screencast bounce sequence, CDP diagnostics, and failure-mode reference.

Both skills land at ~/.claude/skills/<slug> and become discoverable to Claude in this container.

Dependencies

  • octolux-app-server-debug ^0.1.0
  • octolux-web-serial-hmi ^0.1.0

Uninstall

adompkg uninstall ntx-octolux-toolkit
# or remove individual skills:
adompkg uninstall octolux-app-server-debug
adompkg uninstall octolux-web-serial-hmi