Shellbell 0.17.0 — Apps and plugins

Shellbell 0.17.0 adds plugins and local web apps, with Sous as the first integration.

Changes

• Browse reviewed integrations with shellbell plugins. Install Sous 0.27.0 or newer separately, then run shellbell plugins install sous. Providers own their application and declarative plugin package; installation and updates are explicit.
• Open registered apps and confirmed localhost links inside the Android phone app over the encrypted direct connection. Page content stays off the relay. A compatible app appears under its computer's Apps tab.
• Manage on-demand servers, per-phone sign-in and bounded streams through navigation and reconnection. Sous offers an explicit Load board action when it has no cached content.
• Document plugin authoring, isolated phone verification, registry pull requests, and independent application/plugin updates in the plugin guide.

Availability

Tag: shellbell@0.17.0 · Source: e7f24e0fe7d940bc7364e2da767936c208f97a64.

• Apple silicon Mac app: 0.17.0, build 67, macOS 13+. Developer ID signed, notarized and stapled.
• GitHub headless Mac tarball, npm package and shared CLI installer: 0.17.0. The anonymous npm download matches the verified release tarball and its integrity hash.
• Linux ARM64 and x64 archives: 0.17.0, glibc 2.30+. Installers and checksums are attached.

The attached computer-release.json records each artifact's exact SHA-256. The signed Mac app is Apple silicon only; the headless tarball includes both pinned Mac native binaries.

Upgrade and compatibility

Apps requires Android Shellbell 1.2 and computer 0.17 or newer. Mobile is distributed separately; Apps is disabled on iOS. Existing supported secure-v2 phones can continue using terminals and chat with this service. New phone builds can use older supported services with Apps hidden. No new pairing, storage migration or relay deployment is required.

Install/update the application behind a plugin separately. A new registry entry or reviewed pin reaches users with a Shellbell update; compatible provider web UI updates need no provider-specific Shellbell code. Reinstall a managed plugin explicitly to adopt a new package pin.

Qualification and limits

Source CI passed. Signed Mac inventory, native runtime, notarization, stapling and Gatekeeper checks passed. The final Linux archives passed installation/removal regressions, native ICE/DTLS/SCTP and tmux locale checks on Ubuntu 22.04 and 24.04; ARM64 ran natively and x64 under Docker emulation.

Local S22 fixture checks cover Apps, internal previews, live updates, reconnect, the standard dark-theme preference and App Lock. They do not qualify the final Play artifacts, other devices, Android API 28, or a general cross-network matrix. A five-minute idle upper bound was observed after locking; exact timer behavior is covered by source tests. See the qualification checklist.

Recovery

Existing supported terminal/chat combinations remain usable. Preserve computer identities and pairings; keep the previous runtime when updating. A service without Apps support hides that feature on compatible new phones. Published artifacts and tags are immutable; a correction ships as a new version. See installation and updates.

Shellbell 1.2.0 — store rollout

Shellbell 1.2.0 adds separate Agents and Terminals tabs per computer and introduces local Apps and web previews on Android.

Identity and rollout

Tag: mobile-v1.2.0 · Source: e7f24e0fe7d940bc7364e2da767936c208f97a64.

The selected artifacts are the verified 1.2.0 candidate. That record contains their build numbers, exact SHA-256 values and verified internal store assignments.

Platform	Build	Store state
Android	28	Google Play production track assigned and submission accepted; listing propagation has not been independently verified
iPhone and iPad	25	Approved and publicly available as 1.2.0; the public App Store listing is verified

A release tag does not mean both store updates are already visible. TestFlight/internal candidates remain separate from public availability.

Changes

• Each computer has Agents and Terminals tabs. Android also shows Apps when a compatible computer advertises registered applications.
• Android opens plugin apps such as Sous and confirmed localhost previews inside Shellbell, including internal links, live updates and reconnecting visits. Sous offers an explicit Load board action for an empty cache.
• Theme-aware Android pages receive Shellbell's dark preference through the standard browser API. Registered apps omit the redundant address/computer subtitle.
• Include the current Terms of Use acknowledgement.

Requirements and compatibility

Android 1.2 requires Android 9 or newer. Apps needs computer Shellbell 0.17 or newer; install the underlying application separately, then enable its plugin. Sous 0.27.0 is the first provider. Apps is disabled on iOS.

Existing supported secure-v2 phone/service combinations retain terminals and chat; an older supported service hides Apps on a new phone. Older phone apps ignore the new computer catalog. No new pairing or relay deployment is required.

Qualification and limits

Source CI, mobile build identity checks and both internal store assignments passed. Local S22 fixture checks cover Apps, internal navigation, reconnect, dark-theme selection and App Lock. They are separate from final store-artifact, other-device, Android API 28 and cross-network qualification. The remaining device and release checks stay explicit.

Store rollback uses a forward release when a binary cannot be downgraded. Preserve computer keys and pairings; the computer's previous supported terminal/chat behavior remains available. Tags and distributed artifacts are immutable.

Mobile 1.2.0 beta 21.1

Internal mobile candidate 1.2.0

Source: e7f24e0
Android: build 28, Google Play internal testing
iOS: build 25, TestFlight internal testing

Both store assignments were verified. Physical delivery and device QA remain separate from store acceptance.

Android SHA-256: ec00188ab840577784d23dfe24633a3c4c11a5e0b01ac397723ad10493030e83
iOS SHA-256: eb2862bd154c232c74f795e7981167e12b0b6fb5a9636d71c82f7d48e215d14b

Shellbell 0.16.2

Shellbell 0.16.2 updates the Apple silicon Mac app (build 62, macOS 13 or later).

Changes

• With closed-lid keep-awake enabled, remote access pauses when you unplug with the lid closed and resumes when you reconnect power. Stop Service cancels automatic resume.
• Enabling closed-lid mode unchecks and disables Keep awake on battery. Turning closed-lid mode off makes the battery option available again, still unchecked.
• Power observation recovers from missed notifications. Bounded local diagnostics record power-source changes, lid state and verified sleep-override cleanup without terminal content.
• The Devices list shows readable last-seen dates and a sharper pairing QR code.
• The updated Terms of Use identify Miambi as the relay’s pro bono host. The Mac app asks for agreement to the revised terms once.

Install or update

Download Shellbell-0.16.2-arm64.dmg, or use Settings → Check Updates → Install & Restart in the Mac app. Existing identities and pairings are preserved. No phone update or re-pairing is required.

This release contains the Mac app only. CLI and Linux downloads remain at 0.16.1; mobile and relay releases are unchanged.

Qualification

The source passed the workspace lint, typecheck, tests and build, plus 360 native tests (one existing opt-in skip). The DMG passed Developer ID signing, Apple notarization, stapling, Gatekeeper and bundle-integrity verification. GitHub CI passed for the exact source commit.

Physical power tests on local candidates do not complete the final build’s full hardware scenario matrix. Clean-machine installation, offline Gatekeeper, broader helper lifecycle and Intel hardware remain unqualified. This release offers Apple silicon only.

Installation guide · Downloads

Shellbell 0.16.1

Shellbell 0.16.1 includes the Apple silicon Mac app (build 59), the macOS CLI package, Linux ARM64 and x64 archives, and the shared CLI installer.

Improved

• Scrolling back through Chat is much faster. Each page of earlier messages took up to nine seconds to find on the computer, because Shellbell checked which agent owns the pane before every small read of the conversation. It now checks once per page, before the page is sent, so a page takes about half a second. The check still runs on every page, so a different conversation's messages can never reach your phone.

Install or update

curl -fsSL https://shellbell.dev/install.sh | sh

Managed CLI installs: shellbell update. npm installs: npm install -g shellbell@latest. Mac app: Settings → Check for Updates, then Install and Restart.

Qualification and compatibility

The Mac DMG passed Developer ID signing, Apple notarization, stapling and bundle-integrity checks. The CLI package passed an isolated install smoke test. The Linux archives passed installation, a real WebRTC connection, repeat, checksum-failure, synthetic-upgrade and removal checks in Ubuntu 22.04 and 24.04 containers on ARM64 and x64 (emulated). Physical Intel Macs and Windows hosts are not included.

Works with relay 0.4.1 and the current phone apps; no phone update is needed. No re-pairing is required.

Installation guide · Downloads

Mobile 1.1.0 beta 20.1

Internal mobile candidate 1.1.0

Source: 7d0bad2
Android: build 27, Google Play internal testing
iOS: build 24, TestFlight internal testing

Both store assignments were verified. Physical delivery and device QA remain separate from store acceptance.

Android SHA-256: 7c5af363704519c50f430083e9f4a3d13d393438fc9c242549d6cabea1c116be
iOS SHA-256: 09cb07cfedc501ee1470c6edc6bb03290f4cc6e177a573a993b69bc6d7687551

Shellbell 0.16.0

Shellbell 0.16.0 includes the Apple silicon Mac app (build 58), the macOS CLI package, Linux ARM64 and x64 archives, and the shared CLI installer.

New

• Install updates from the Mac app. After Check for Updates finds a newer version, Install and Restart downloads it and checks that it's signed by Shellbell's developer, accepted by macOS and exactly the version offered. It then quits, updates and opens Shellbell again. The old app goes to the Trash, and keep-awake and closed-lid stay on. If anything doesn't check out, nothing is replaced. If the new version can't be put in place or won't open, the current one opens again and says so. This is the last update you install by hand: from 0.16.0 on, updates install from the app.

Improved

• Quit always lets you out. When Shellbell can't confirm that remote access and keep-awake stopped, Quit asks whether to quit anyway instead of reopening Settings, and says what it couldn't confirm. Remote access always ends with the app.
• Shellbell says when it can't read its own status. Instead of showing an old "Connected" next to greyed-out buttons, it says "Can't read Shellbell's status" and offers Try Again, in Settings and in the menu bar.
• Closing a pairing while Shellbell can't read its status no longer disconnects your phones.

Install or update

curl -fsSL https://shellbell.dev/install.sh | sh

Managed CLI installs: shellbell update. npm installs: npm install -g shellbell@latest. Mac app: Settings → Check for Updates, then install the DMG (one last time). Keep-awake and closed-lid stay on when the new version opens within 15 minutes of quitting the old one; otherwise turn them back on.

Qualification and compatibility

The Mac DMG passed Developer ID signing, Apple notarization, stapling and bundle-integrity checks, and the same signature, notarization and version checks Install and Restart runs. The CLI package passed an isolated install smoke test. The Linux archives passed installation, a real WebRTC connection, repeat, checksum-failure, synthetic-upgrade and removal checks in Ubuntu 22.04 and 24.04 containers on ARM64 and x64 (emulated). Physical Intel Macs and Windows hosts are not included.

Works with relay 0.4.1 and the current phone apps. No re-pairing is required.

Installation guide · Downloads

Shellbell 0.15.1

Shellbell 0.15.1 includes the Apple silicon Mac app (build 57), the macOS CLI package, Linux ARM64 and x64 archives, and the shared CLI installer.

Fixed

• Keep-awake keeps working. In 0.15.0, once an agent newer than Shellbell has tested started (such as a new Claude Code), the Mac app could no longer read the service's status. Keep-awake and closed-lid then quietly stopped while their switches still showed on, so the Mac could sleep overnight and your phone couldn't connect. The app now reads status as before, and the Mac stays awake.
• shellbell connect and shellbell config set conversations failed the same way after a newer agent started. Both work again.

If you use the Mac app with keep-awake, update now. Keep-awake and closed-lid stay on when the new version opens within 15 minutes of quitting the old one; otherwise turn them back on.

Install or update

curl -fsSL https://shellbell.dev/install.sh | sh

Managed CLI installs: shellbell update. npm installs: npm install -g shellbell@latest. Mac app: Settings → Check for updates, then install the DMG.

Qualification and compatibility

The Mac DMG passed Developer ID signing, Apple notarization, stapling and bundle-integrity checks. The CLI package passed an isolated install smoke test. The Linux archives passed installation, a real WebRTC connection, repeat, checksum-failure, synthetic-upgrade and removal checks in Ubuntu 22.04 and 24.04 containers on ARM64 and x64 (emulated). Physical Intel Macs and Windows hosts are not included.

Works with relay 0.4.1 and the current phone apps. No re-pairing is required.

Installation guide · Downloads

Shellbell 0.15.0

Shellbell 0.15.0 includes the Apple silicon Mac app (build 56), the macOS CLI package, Linux ARM64 and x64 archives, and the shared CLI installer.

What's new

• Chat opens the right way. Each agent session tells the phone whether its chat can be shown before you open it: found, not started yet, or not available and why. A new agent's first message can be sent from Chat.
• Nothing is typed into the wrong place. A message sent from Chat is checked on the computer just before it is typed. If the agent changed, quit, is waiting for an answer, or its screen can't be checked, nothing is typed and the phone says why.
• An idle chat costs nothing. An open chat does no work while nothing changes, where it used to check several times a second. New messages go out as soon as they are written, and a chat on screen no longer waits behind terminal output.
• Herdr changes no longer reset chats. Opening or closing a Herdr pane used to reset every open chat. Now the chat reopens as soon as Herdr settles, with its first page straight after.
• Queued messages. Messages Claude has queued while busy are shown beside the chat.
• Fewer warnings. New Claude bookkeeping records and agent versions newer than tested no longer show warnings in Chat; shellbell doctor mentions newer agent versions instead.
• New sessions open where you'd expect. A session started from the phone opens as a tab in a Herdr, tmux or iTerm2 window already showing on the computer, and in a new window when none is. Herdr splits work from the phone. The phone now says exactly where each one opened, and iTerm2 opens a new window if its front window closes just as the tab opens.

Phone app

The new Chat needs the phone app candidate built with this release (mobile 1.0.0 internal testing). Older phone builds keep working with this computer, without the new Chat checks.

Install or update

curl -fsSL https://shellbell.dev/install.sh | sh

Managed CLI installs: shellbell update. npm installs: npm install -g shellbell@latest. Mac app: Settings → Check for updates, then install the DMG.

Qualification and compatibility

The Mac DMG passed Developer ID signing, Apple notarization, stapling and bundle-integrity checks. The CLI package passed an isolated install smoke test. The Linux archives passed installation, a real WebRTC connection, repeat, checksum-failure, synthetic-upgrade and removal checks in Ubuntu 22.04 and 24.04 containers on ARM64 and x64 (emulated). Chat was tested on an Android phone against Herdr on a Mac; the tab-or-window notice and the iTerm2 fallback are covered by automated tests only. Physical Intel Macs and Windows hosts are not included.

Works with relay 0.4.1. No re-pairing is required.

Installation guide · Downloads

Mobile 1.0.0 beta 18.1

Internal mobile candidate 1.0.0

Source: fde4c77
Android: build 25, Google Play internal testing
iOS: build 23, TestFlight internal testing

Both store assignments were verified. Physical delivery and device QA remain separate from store acceptance.

Android SHA-256: f1a2175af7bfeb1a7348f5338047073ab14d39760f891b0bb39340a78d97b298
iOS SHA-256: 5d1a664376e7fe7ccdcec36fa606c714cb374f723c07424e7c058a89630f22dd