Skip to content

Shellbell 0.10.0

Choose a tag to compare

@bilal- bilal- released this 23 Oct 02:02
· 387 commits to main since this release

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 | sh

It 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.0

Both 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 update upgrades. shellbell update --check checks 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.

Installation guide · Downloads