Skip to content

cmdSwitch3 1.0.0 — first stable release

Latest

Choose a tag to compare

@jakemike1 jakemike1 released this 17 Nov 11:18

First stable release

cmdSwitch3 1.0.0 brings local shell and remote SSH switches, momentary actions and dimmable lights to Homebridge 2 on Linux and macOS.

This release promotes the tested beta.6 runtime unchanged. Command execution, switches, dimming, sequential commands, accessory identities, settings assets, configuration rules and dependency versions are identical to beta.6. Changes are limited to version/publishing metadata, documentation and issue-template wording.

  • Install or update through Homebridge UI, searching for homebridge-cmdswitch3, or use npm install -g homebridge-cmdswitch3@latest with your usual Homebridge npm prefix.
  • npm's latest tag selects stable 1.0.0. The beta tag remains on 1.0.0-beta.6; an exact beta.6 install remains available for rollback.
  • Existing cmdSwitch3 users can update normally while retaining configuration, cached accessories and pairing data. Existing cmdSwitch2 users must follow MIGRATION.md; installation does not automatically take over cmdSwitch2 accessories.
  • Requires Homebridge 2 and Node 22, 24 or 26 on Linux or macOS. No runtime npm dependencies or installation hooks.

Validation at release commit 9e453f503ec030a06824848999ec8ee5b12ff959: all nine CI jobs pass across Linux x64, native Linux ARM64 and macOS with Node 22, 24 and 26. Each job runs 78 tests, syntax/shared-validator and formatting checks, plus an offline packed-install/HAP check. Local macOS ARM64 checks also pass. Byte comparisons confirm the runtime, UI and schema match beta.6 and dependency versions are unchanged.

The maintainer has confirmed beta.6 installed and working in everyday Raspberry Pi switch and automation use, including local heating and hot-water command helpers. Physical dimming, multiple-installation sequential use and diverse command scripts still need broader coverage; see TESTING.md.

Homebridge verification request #1287 remains awaiting final review. Stable release status is not Homebridge verification approval. This release does not deploy to or restart the maintainer's Pi.