Download Shellbell

For your computer.
And your phone.

Install the computer service and the mobile app. Scan the pairing QR, approve your phone, and open a session.

Mac app

Native macOS app

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 builds

iTerm2, tmux, and Herdr. Follow the release’s architecture and installation notes.

Headless service

macOS & Linux

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 builds

macOS setup / Linux setup. Headless mode does not manage computer sleep.

Phone

iOS & Android

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 builds

App Store and Google Play links will be added here when published. Custom relay push has additional configuration requirements.

Source

Build it your way.

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 GitHub

Computer, 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.

One computer.
One phone. You’re in.

Choose compatible builds from the release notes, keep your computer awake, and follow the pairing steps.

Run the computer service.

Use the Mac app, or start the headless service on Linux. Open a supported terminal session.

Scan and approve.

Open pairing on your computer. Scan the temporary QR code with your phone, then approve that phone on the computer.

Pick a session.

Read, type, and respond. Everything still runs on your computer, in the same terminal you started with.

Walk through the setup

Is Shellbell free?

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.

Can I use Windows as my computer?

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.

Where are the installation instructions and checksums?

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.

Can I use my own relay?

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.

For your computer.And your phone.