Repository navigation
Shellbell 0.10.0
Shellbell 0.10.0 includes the Apple silicon Mac app (build 33), macOS npm CLI, Linux ARM64/x64 archives, and a shared CLI installer.
Install the CLI
The shared installer includes its runtime; Node, npm and Homebrew are not prerequisites. Run it as your normal user:
curl -fsSL https://github.com/bilal-/shellbell/releases/download/shellbell%400.10.0/install-cli.sh | shIt installs a launcher at ~/.local/bin/shellbell. Add ~/.local/bin to your PATH, or use the full path. On macOS it uses a private copy of the signed Mac runtime and does not replace the menu-bar app.
npm remains supported on macOS with Node.js 22 or newer:
npm install -g shellbell@0.10.0Both installation methods use the same CLI code. The shared installer additionally supplies its runtime and manages manual CLI upgrades.
Updates and setup
- Managed Apple silicon CLI and Linux archive installs support confirmed
shellbell updateupgrades.shellbell update --checkchecks metadata without downloading an app or archive. Previous runtimes and pairings are retained; restarting a service remains an explicit action. - npm installations continue to use
npm install -g shellbell@latest. Mac menu-bar users can check for updates in Settings and install the official DMG. - For a new Mac CLI installation, run
~/.local/bin/shellbell start. Linux additionally requires explicit host initialization:~/.local/bin/shellbell host init --new && ~/.local/bin/shellbell start. Existing desktop-owned identities require the documented ownership conversion before headless use. - Installation does not start a service, change power settings, or replace identities and pairings. No automatic checking or downloading is introduced.
- Permission guidance now explains that commands and developer tools can trigger macOS prompts attributed to their launching app. Terminal mirroring does not require broad personal-folder access.
Qualification and compatibility
The Mac DMG passed Developer ID signing, Apple notarization, stapling, Gatekeeper, bundle-integrity and native WebRTC loopback checks. Isolated managed-CLI tests cover install/reinstall, update confirmation, corruption and stale-selection refusal, state preservation, and installing the exact signed target. The older-version update fixture changes only version metadata in memory; it is not a previously shipped signed CLI.
Linux archives passed Ubuntu 22.04/24.04 installation/removal, native WebRTC, tmux/locale and two-user tests (ARM64 native; x64 emulated). Bundled updater tests use isolated synthetic newer-release fixtures. Source and artifact audits passed. Real service login/reboot, clean-machine Mac/offline Gatekeeper, physical-device and native x64 lifecycle checks remain separate qualification.
No mobile or relay update, wire migration, or re-pairing is required. Mobile remains on its existing internal-testing release. Intel Mac and Windows host builds are not included.