jetson-promote-image

What problem does it solve?

Manually copying customized BSP overlay files and rebuilt kernel artifacts to a staged BSP image is error-prone, risks missing critical files, and can lead to stale kernel/module version mismatches that cause boot failures on Jetson devices.

Core Features & Use Cases

• Two-channel automated promotion: Copies both overlay customization outputs (e.g., config files, hand-edited device tree blobs) and build artifacts (kernel Image, in-tree/out-of-tree modules, NVIDIA DTBs) from the source workspace to the staged BSP image.
• Diff-aware idempotent operation: Skips byte-identical files, so re-runs are safe and automatically resume if interrupted by errors like permission issues or disk full.
• Automatic initramfs coherence: Mirrors updated kernel images to the rootfs and rebuilds the initramfs when kernel or module files change, eliminating boot failures from module shadowing or symbol version skew.
• Use Case: After customizing fan control configs and rebuilding the kernel for a Jetson Orin NX, use this skill to stage all changes into the BSP image in one step, with no manual copy work or risk of stale boot files.

Quick Start

Use the jetson-promote-image skill to automatically stage all customized overlay files and rebuilt kernel artifacts from your active Jetson BSP workspace into the staged BSP image, preparing it for flashing to a device.