Usuba Checker Scripts v0.1.0

The first release of the Usuba Checker Scripts: plain-Python tests that check whether an Omarchy plugin really works. Released with the Usuba Checker Model v0.1.0. Project site: usuba.dev.

What's in it

• Usuba Standard v0.2: 66 rules. Each finding has a rule id, a reason and a Fix: hint.
• Static checks that run on any machine, with Python 3.10+ and no dependencies.
• A runtime stage that boots the real Omarchy 4.0.4-1 shell. It needs the reference Linux build; anywhere else, the output says the stage was skipped.
• Calibration: checked against a Dell Latitude 7430 running Omarchy. It agrees with the hardware answer key on 90 of 90 decided cases, and gets 0.773 of verdicts right on the Dell 75 exam (preliminary results, October 2026).

Get it

git clone --branch checker-v0.1.0 https://github.com/outboundsync/usuba-checker-scripts
cd usuba-checker-scripts
python3 functest/functest.py path/to/your-plugin --reasons

To use it from Python:

pip install "usuba-checker @ git+https://github.com/outboundsync/usuba-checker-scripts@checker-v0.1.0"

More: usuba.dev/docs/get · Run a check · How Usuba was built and tested

Licence: MIT, © 2026 OutboundSync.