Install the computer service and the mobile app. Scan the pairing QR, approve your phone, and open a session.
Pair your phone, manage the service, and change settings from the menu bar. Optional power controls can keep your Mac awake on external power while the desktop service is running.
Get Mac buildsiTerm2, tmux, and Herdr. Follow the release’s architecture and installation notes.
Prefer a service without a desktop app? Run Shellbell under your user’s service manager: launchd on macOS or systemd on Linux. Linux sessions use tmux.
Get headless buildsmacOS setup / Linux setup. Headless mode does not manage computer sleep.
Read output, switch sessions, send input, and open notifications to return to your work. Use the same free app with the project relay or one you host yourself.
Get mobile buildsApp Store and Google Play links will be added here when published. Custom relay push has additional configuration requirements.
Read the code, contribute an improvement, build your own clients, or deploy a relay on infrastructure you control. Shellbell’s code is MIT licensed.
Explore on GitHubComputer, relay, and mobile components have separate release lines.
Downloads go directly to GitHub Releases. Version requirements and installation steps live with each release. A Windows computer service is planned.
Choose compatible builds from the release notes, keep your computer awake, and follow the pairing steps.
Use the Mac app, or start the headless service on Linux. Open a supported terminal session.
Open pairing on your computer. Scan the temporary QR code with your phone, then approve that phone on the computer.
Read, type, and respond. Everything still runs on your computer, in the same terminal you started with.
Yes. Shellbell is a free, open-source project with no ads, paywalls, or data mining. If you choose to self-host a relay, your own infrastructure and notification provider requirements remain your responsibility.
A Windows computer service is planned. The supplied computer options are the native macOS app and headless macOS or Linux service. See GitHub Releases for the platform support of each artifact.
Use the notes and assets attached to the relevant GitHub release. Computer, relay, and mobile versions are tracked separately, so follow the documented compatibility requirements rather than matching version numbers alone.
Yes. Point your computer and phone at the same custom WSS address. The relay page explains the Cloudflare and standalone server options, including the extra requirements for background push.