JetBrains/thinkrail

ThinkRail ships in two additive forms: a native desktop installer and the self-contained `thinkrail` CLI. Both are published with `SHA256SUMS` on the [releases page](https://github.com/JetBrains/thinkrail/releases). Download the `thinkrail-desktop-*` asset for your platform: - **macOS 14+ (Apple Silicon or Intel)** — open the DMG for your architecture: `thinkrail-desktop-darwin-arm64.dmg` or `thinkrail-desktop-darwin-x64.dmg`. - **Windows x64** — extract the complete setup ZIP, then run its setup executable in place, next to its payload. - **Linux x64 / ARM64** — extract the setup tarball and run `installer`. Desktop builds need glibc 2.38+ with GTK 3, WebKitGTK 4.1, Ayatana AppIndicator 3, and librsvg 2 — Ubuntu 24.04 or newer:

  sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0 libayatana-appindicator3-1 librsvg2-2

Packaged stable and nightly desktop builds check for updates in the background and offer them in **Settings → Updates**: **Download** → **Preparing update** → **Install & Restart**. Nothing is applied until you choose **Install & Restart**. ThinkRail then shows the installation's progress and log, closes, and reopens on the new version. After the restart it tells you whether the update installed. If it didn't, it explains why and offers to retry. The updater appears only when the package carries a valid HTTPS feed identity; installations that predate that identity need one manual installation first. The installer downloads the right binary, verifies its SHA-256 checksum, and puts `thinkrail` on your PATH. **macOS / Linux** (also Windows under Git Bash):

curl -fsSL https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.sh | bash

**Windows** — the same command works from cmd and PowerShell:

powershell -c "irm https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.ps1 | iex"

Then run `thinkrail`, optionally with a git repo to open as a project:

thinkrail ~/code/my-repo

`thinkrail` needs `git` on your PATH and a model provider — sign in with JetBrains AI from the app or use your own provider credentials. `thinkrail --help` lists the flags; `thinkrail --version` prints the build. Nightly builds, pinned versions, updates, and uninstall The installer takes `--channel stable|nightly` and `--version`; a pinned version must belong to the selected channel:

curl -fsSL https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.sh | bash -s -- --channel nightly
curl -fsSL https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.sh | bash -s -- --channel stable --version 0.1.2
curl -fsSL https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.sh | bash -s -- --channel nightly --version 0.2.0-nightly.10

On Windows the options are environment variables (`THINKRAIL_CHANNEL`, `THINKRAIL_VERSION`, `THINKRAIL_PREFIX`, `THINKRAIL_NO_MODIFY_PATH`):

$env:THINKRAIL_CHANNEL='nightly'; irm https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.ps1 | iex   # PowerShell
set "THINKRAIL_CHANNEL=stable" && set "THINKRAIL_VERSION=0.1.2" && powershell -c "irm https://raw.githubusercontent.com/JetBrains/thinkrail/main/install.ps1 | iex"   # cmd

Installed stable and nightly CLI hosts periodically offer **Run Update** in **Settings → Updates**. It runs the host machine's `thinkrail update` in the background — also when the UI is open in a browser on another machine — and a successful update asks you to restart the host manually. You can run `thinkrail update` directly on any platform: it re-runs the installer for the installed channel and replaces `/bin/thinkrail[.exe]`; pass `--channel` or `--version` only for an explicit override. `thinkrail uninstall` removes the executable, the PATH entry the installer added, and the install metadata, and asks whether to delete your `~/.thinkrail` app state (kept by default — `--remove-data` deletes it, `-y` skips the questions). Prefer