| name | openrig-tooling |
| description | Use when you need to build, package, sign, render, or test OpenRig — running any of its scripts/tools (macOS .dmg, Linux .deb/Orange Pi image, headless Slint PNG render, coverage, the real-hardware test battery) and you need the exact command plus the non-obvious prerequisites. |
OpenRig Tooling Runbook
Overview
Index of how to actually run OpenRig's tooling, with the gotchas that aren't
obvious from the script names. The per-script detail lives in docs/scripts.md
and each script's header comment + --help; this skill is the fast path and
fills the gaps those don't cover.
Golden rule (LEI ZERO): an agent never builds in the user's main working
tree. Work in a .solvers/issue-N clone (or, for a throwaway artifact, a temp
clone outside the repo). Clone the branch you actually want — a build from a
stale clone ships stale code.
When to use
- "build me a mac app / .dmg", "package", "make a release artifact"
- "render this screen / check the layout" (Slint → PNG, no GUI)
- "run the tests" including the ones that open the real audio interface
- ".deb for the Orange Pi", flashing an SD image
- coverage report
Not for: editing code (see openrig-code-quality), or UI design work (see
slint-best-practices + ui-ux-pro-max).
Quick reference
| Goal | Command (from repo root) |
|---|
| macOS universal .dmg | OPENRIG_PLUGINS_DIR=<plugins> ./scripts/package-macos.sh <ver> |
| macOS build + install to /Applications | OPENRIG_PLUGINS_DIR=<plugins> ./scripts/install-macos-local.sh [ver] (dev; builds via packager, quits+replaces+launches) |
