Repository navigation
Releases
SidePulse.NET 0.1.0-beta.2
SidePulse.NET 0.1.0-beta.2
Single-file portable executables with per-user installation and optional user PATH setup.
- Each runtime archive contains one self-contained executable plus its small
format-2 update manifest. Docs, dependency/runtime licenses and notices are embedded.
A copied executable works alone; native runtime libraries can use a per-user cache. spn install --dry-run,spn install,spn install --statusand the interactive
Settings → Installation screen provide a permanent per-user location without elevation.--add-to-pathchanges only user PATH on Windows. Unix uses a managed user-bin
launcher and, when needed, one explicit backed-up Bash/Zsh/sh profile block.
Command-name conflicts are refused. Repeated installation is idempotent.- New hook and detached-host setup use the stable installed executable. Existing
hook files still require explicit uninstall/reinstall; manual edits are preserved. - Verified upgrade, startup probe and rollback support the bundle layout.
Uninstall removes owned binaries/PATH entries while keeping credentials, settings,
user-added files and profile backups. Installed-process removal uses a waiting helper.
Install or upgrade
Download the matching Windows/Linux/macOS x64 or ARM64 archive and verify
SHA256SUMS. Extract and run .\spn.exe install --dry-run (PowerShell) or
./spn install --dry-run (Unix). Apply with install, optionally adding
--add-to-path; Unix supports --shell bash, zsh or sh.
The absolute installed executable works immediately; reopen terminals after PATH setup.
Beta 1's updater does not understand format 2. For that one transition, stop the
host, download the new executable, and use its installer or a separate permanent
directory. Existing owned/verified installations can be upgraded with backups;
unowned destinations and edited files are refused. Alpha's command rename still
requires the manual integration transition recorded in beta 1's notes.
Use spn docs --offline for full installation, PATH ownership and recovery details.
Hardware/firmware and installed-provider acceptance remain separate from native
CI. Other architectures are cross-built, and packages remain unsigned. Full saved
UI preferences and automatic migration of edited integrations remain open.
This candidate remains an unpublished draft until acceptance is reviewed.
SidePulse.NET 0.1.0-beta.1
SidePulse.NET 0.1.0-beta.1
First beta candidate. The command is now spn (spn.exe on Windows).
The product and repository remain SidePulse.NET. No old-name alias is included.
Changes
- Interactive launches stay open after commands. Home, section navigation and a
searchable/action palette support repeated work; Esc at Home stays in the app. - Send state keeps its output and Preview mode during the session. Choose a state
and press Enter to send again. Output selection lists connected devices and saved phones. - Script commands leave simple arguments unquoted and escape shell-sensitive values.
Portable executable paths use an absolute invocation whenspnis not on PATH. - State, write, animation and host delivery select one mounted USB device, otherwise
the saved default or sole phone. Explicit targets never fall back on failure. - Native OpenCode event plugin joins Copilot, Codex, Claude Code and Kiro integrations.
Downloads and installation
Choose exactly one archive for your OS and architecture:
| OS | x64 | ARM64 |
|---|---|---|
| Windows | spn-win-x64.zip |
spn-win-arm64.zip |
| macOS | spn-osx-x64.tar.gz |
spn-osx-arm64.tar.gz |
| Linux | spn-linux-x64.tar.gz |
spn-linux-arm64.tar.gz |
Verify the archive against SHA256SUMS, then extract the complete archive into
its own permanent directory. Windows suggestion: %LOCALAPPDATA%\Programs\SidePulse.NET;
macOS/Linux: a user-owned directory under ~/.local/share/SidePulse.NET.
Run .\spn.exe in PowerShell or ./spn on Unix. An optional manual user PATH entry
lets other terminals use spn; reopen terminals after changing PATH.
This beta uses self-contained directory packages, not single-file executables.
Do not copy the apphost alone: runtime files and sidepulse-install.json are required.
There is no automatic installer, PATH/profile modification or signing in this beta.
spn docs --offline and spn about licenses --full work without a network connection.
Upgrade from the alpha preview
- With the old executable, stop the host and uninstall each managed integration
using its existing--configoverride where applicable. Existing ownership checks
refuse modified files; preserve those files and merge them manually. - Extract the new complete package into its permanent directory. Keep the old copy
until the new setup is verified. Do not use the alpha updater to cross this rename. - Run
spn link listand confirm saved phone aliases are present. Storage paths,
native credential identity, profiles and IPC identity are unchanged. - Reinstall integrations with
spn agents install <provider>from the permanent
executable. Restart the agents and review their normal trust prompts. - Start the host, send one test state and verify the actual device display.
Remove obsolete downloaded files manually after verification.
Existing provider filenames such as sidepulse-net.json and sidepulse-net.js
remain ownership identifiers. They are not compatibility executables.
Validation and remaining limits
Native CI builds/tests on Windows x64, Linux x64 and macOS ARM64, exercises generated
hooks/plugins, and tests update replacement and rollback with simulated hardware.
Other architecture packages are cross-built; they still need native acceptance.
Real device/firmware parity and each installed agent version need separate recorded
acceptance. Bridge HTTP success does not acknowledge the physical LED display.
Linux saved links require Secret Service; macOS uses Keychain; Windows uses DPAPI.
The persistent UI is an initial delivery slice: comprehensive saved settings,
first-run installation, automatic managed-hook repair and the full responsive frame
remain open in issues #17/#18. Existing advanced setup forms are still guided menus.
Updates require stopping the host and running outside the installation directory;
retain backups until spn update status confirms success.
This release remains a draft until its packages and acceptance have been reviewed.