Repository navigation
Description
Plugin Name
homebridge-cmdswitch3
Link To GitHub Repo
https://github.com/jakemike1/homebridge-cmdswitch3
Plugin Icon (Optional)
Download the 100×100 PNG. Original cmdSwitch3 artwork: a command prompt inside an ON switch.
The plugin does not offer the same nor less functionality than that of any existing verified plugin.
🟢 Yes
The plugin successfully installs and does not start unless it is configured.
🟢 Yes
The plugin does not require the user to run Homebridge in a TTY or with non-standard startup parameters, even for initial configuration.
🟢 Yes
The plugin does not contain any analytics or calls that enable you to track the user.
🟢 Yes
If the plugin needs to write files to disk (cache, keys, etc.), it stores them inside the Homebridge storage directory.
🟢 Yes
The plugin does not throw unhandled exceptions, the plugin must catch and log its own errors.
🟢 Yes
More Information
cmdSwitch3 is a maintained Homebridge 2 dynamic-platform fork of luisiam/homebridge-cmdswitch2 for Linux and macOS. The original Apache-2.0 licence and attribution are retained.
Published release: homebridge-cmdswitch3 1.0.0 on npm, with GitHub stable release notes. npm latest points to 1.0.0, matching GitHub's package.json; the beta tag remains on 1.0.0-beta.6. Testing instructions, migration guidance and issue reporting are public.
Stable release scope: 1.0.0 promotes the tested beta.6 runtime unchanged. Command execution, switches, dimming, sequential commands, accessory identities, Settings UI assets, schema/defaults and dependency versions are identical to beta.6. The release changes only version/publishing metadata, documentation and issue-template wording.
Distinct functionality: command switches plus native Lightbulb dimmers using HB_BRIGHTNESS, restoration of the last confirmed brightness, and optional FIFO command ordering across the platform, including state reads. It also preserves cmdSwitch2's name-derived identities and configuration semantics through an explicitly managed migration; installation alone does not take over another plugin's accessories.
We compared it with verified homebridge-script2, which already offers script switches, timeouts, sequencing and shared reads. Its documented interface does not include native brightness or cmdSwitch2 identity migration. cmdSwitch3 is not a superset: script2 also offers file-watched state and optional early acknowledgement. We welcome the team's assessment of this distinction.
Local shell and SSH support: documentation and the Settings UI cover service-account SSH setup, verified host keys, non-interactive authentication, remote switches, momentary actions and dimming. With opt-in strictState: true, switch-state exit 0 means ON, exit 1 means confirmed OFF, and other exits (including SSH error 255) report an error while retaining the last confirmed state. A documented helper maps remote utility failures to error 2. SSH uses the host's existing client, service-account configuration and credentials; no credential fields or connection manager are added.
Implementation: no runtime dependencies, installation hooks, telemetry or separate UI server. The custom Settings UI and JSON schema support switches/dimmers, sequential commands and opt-in quiet logging that retains errors. Plugin-owned state stays in Homebridge accessory context. Missing configuration stays inactive; invalid configuration/cache and unexpected startup/state-publication failures stop the affected platform with sanitized diagnostics and retained cached accessories. Command deadlines, output limits, stream failures, failed writes and shutdown are regression-tested. User-configured commands run with the Homebridge service user's permissions.
Passing CI, including native Linux ARM64: all nine jobs at the 1.0.0 release commit passed before publication, covering Linux x64, native Linux ARM64 and macOS on Node 22, 24 and 26. Each job runs 78 tests, syntax/shared-validator checks, formatting and an offline packed-install/HAP check. Local macOS ARM64 build, formatting and packaged-install checks also pass.
Release and CI commit: 9e453f503ec030a06824848999ec8ee5b12ff959. The downloaded npm 1.0.0 registry archive matches the tested 16-file package byte-for-byte (SHA-256 f56fb43f6e7c7e19c385e122cb15368250b86d219964c023ad70d55ab8f18163). Byte comparisons also confirm that the runtime, UI and schema match beta.6 and dependency versions are unchanged.
Real-world use and remaining coverage: 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, sequential use across multiple installations and diverse command scripts still need broader community coverage. Native Ubuntu ARM64 CI does not establish universal Raspberry Pi or Debian compatibility. Synthetic migration tests preserve six switches' and a dimmer's HAP identities across cache restoration; they do not establish universal migration safety. This release intentionally supports Homebridge 2 only.
Verification status: the previous Homebridge automated result passed on beta.3; it is not a 1.0.0 result. The scanner's environment-access flag in command-runner.js remains for manual review and is not a confirmed vulnerability. Final Homebridge team review remains pending; publishing a stable release does not itself confer verification approval.
Activity
github-actions commentedon Oct 22, 2026
🔴 Failed Checks
🟢 Passed Checks
homepageexistsbugs.urlexists and seems a valid URLkeywordsexist and contain'homebridge-plugin'keywordsdeclare the supported transports ('supports-hap'and/or'supports-matter')'preinstall'inscriptsis not present'install'inscriptsis not present'postinstall'inscriptsis not presentengines.nodeproperty is compatible with Node 22engines.nodeproperty is compatible with Node 24engines.homebridgeproperty is compatible with Homebridge 2.4.0typepropertypropertiesfor object typepluginAliaspluginTypeis set to'platform'nameschema propertyhomebridgeis not declared as a runtime/peer/bundled dependencyhap-nodejsis not declared as a runtime/peer/bundled dependency🔍 For Manual Review
The following items were detected and require manual review. We understand that these items may be false positives.
ℹ️ Check Details
v1.0.0-beta.2of the plugin.📋 Next Steps
/checkon this issue to run the checks again — your request will not move forward until the checks are re-run.package.jsonandconfig.schema.jsonfiles, don't forget to publish a new version to NPM.jakemike1 commentedon Oct 22, 2026
The npm distribution tags are now aligned: both
latestandbetapoint to1.0.0-beta.3, matching the version in GitHub'spackage.json. This remains a public beta and the GitHub release remains marked as a prerelease; no package contents were changed.The existing nine-job CI run is passing, including native Linux ARM64 on Node 22, 24 and 26.
/check
github-actions commentedon Oct 22, 2026
🟢 Passed Checks
homepageexistsbugs.urlexists and seems a valid URLkeywordsexist and contain'homebridge-plugin'keywordsdeclare the supported transports ('supports-hap'and/or'supports-matter')'preinstall'inscriptsis not present'install'inscriptsis not present'postinstall'inscriptsis not presentengines.nodeproperty is compatible with Node 22engines.nodeproperty is compatible with Node 24engines.homebridgeproperty is compatible with Homebridge 2.4.0typepropertypropertiesfor object typepluginAliaspluginTypeis set to'platform'nameschema propertyhomebridgeis not declared as a runtime/peer/bundled dependencyhap-nodejsis not declared as a runtime/peer/bundled dependency🔍 For Manual Review
The following items were detected and require manual review. We understand that these items may be false positives.
ℹ️ Check Details
v1.0.0-beta.3of the plugin.📋 Next Steps
All checks passed successfully, nice work! Your plugin and/or icon will now be manually reviewed by the Homebridge team.
jakemike1 commentedon Nov 17, 2026
Stable 1.0.0 is now published on npm, with GitHub release notes. I have updated the submission above.
npm
latestis1.0.0, matching GitHub'spackage.json;betaremains1.0.0-beta.6. The stable release promotes the beta.6 runtime, UI, schema and dependency versions unchanged.All nine CI jobs at the release commit passed: 78 tests per job across Linux x64, native Linux ARM64 and macOS on Node 22, 24 and 26, plus formatting and packaged-install/HAP checks. The published npm archive matches the tested package byte-for-byte. The submission and testing guide retain the remaining coverage limitations.
Please rerun the automated checks against 1.0.0. I understand that final manual review, including the existing scanner flag, remains pending.
/check
github-actions commentedon Nov 17, 2026
🟢 Passed Checks
homepageexistsbugs.urlexists and seems a valid URLkeywordsexist and contain'homebridge-plugin'keywordsdeclare the supported transports ('supports-hap'and/or'supports-matter')'preinstall'inscriptsis not present'install'inscriptsis not present'postinstall'inscriptsis not presentengines.nodeproperty is compatible with Node 22engines.nodeproperty is compatible with Node 24engines.homebridgeproperty is compatible with Homebridge 2.5.0typepropertypropertiesfor object typepluginAliaspluginTypeis set to'platform'nameschema propertyhomebridgeis not declared as a runtime/peer/bundled dependencyhap-nodejsis not declared as a runtime/peer/bundled dependency🔍 For Manual Review
The following items were detected and require manual review. We understand that these items may be false positives.
ℹ️ Check Details
v1.0.0of the plugin.📋 Next Steps
All checks passed successfully, nice work! Your plugin and/or icon will now be manually reviewed by the Homebridge team.