get started / install

Install Clawdline and open your Sessions.

Install Clawdline, then follow the app’s guide to connect your devices.

Checked against the product on 22 October 2026

Latest release: Clawdline v2.9.0 · platform support

1. Install the release

Download for Mac

Apple Silicon · macOS 13+

curl -fsSL https://clawdline.com/install.sh | sh

2. Check installation

clawdline doctor

In the Mac app’s Local tab, choose Setup at the top right.

The Mac app’s top-right Setup 0/3 button, outlined in orange

Start setup → Connect with GitHub

The setup guide’s Connect your account screen and Connect with GitHub button

Pair in browser

The setup guide’s browser step and Pair in browser button

3. Pair your phone

iPhone / iPad

  1. Safari: app.clawdline.com → Share → Add to Home Screen

    iPhone Safari Home Screen installation confirmation

  2. Show the QR code in the Mac app

    The Mac app’s iPhone / iPad setup tab with an example QR code
    Setup guide example. Scan the QR shown on your own Mac.

  3. Scan inside the phone app

Android

  1. Chrome: app.clawdline.com → ⋮ → Add to Home screen

    Android Chrome Home Screen installation confirmation

  2. Show the QR code in the Mac app

    The Mac app’s Android setup tab with an example QR code
    Setup guide example. Scan the QR shown on your own Mac.

  3. Scan inside the phone app

4. Update when a release is available

The Settings page shows the running and available versions. Choose Update now, or run clawdline update --apply. A failed startup rolls back to the previous release; existing tmux Sessions keep running. Automatic updates are off until you enable them on this machine.

Platform differences

macOSLinux desktopLinux without a desktop
ConsoleBrowser; Apple silicon also gets the appBrowserBrowser over an SSH port forward
Session sourcestmux and iTerm2tmuxtmux
ServiceLaunchAgentsystemd --usersystemd --user

The release installer has been checked on Ubuntu 24.04 and Debian 12. Other Linux desktops and distributions still need their own validation. On a machine without a desktop, see the printed SSH forwarding instructions.

Stop or remove Clawdline

To remove the service, app, command and releases while keeping your Sessions and settings:

clawdline setup --uninstall

To also erase paired devices, settings and Clawdline's state, use clawdline setup --uninstall --purge. The installer can do the same with --uninstall if the command is no longer installed. Open tmux Sessions keep running.

For install options, verified release details, source builds and troubleshooting, read the installation guide and troubleshooting.