Get Rysh for your desktop

The agentic execution environment as a native app — panes, agents and embedded web views in one window. The rysh CLI is bundled; you do not need to install it separately.

macOS (Apple silicon or Intel; signed and notarized) · Linux (x86-64; AppImage or .deb)

The Linux AppImage needs libfuse2 (libfuse2t64 on Ubuntu 24.04) — or use the .deb instead. On Ubuntu 24.04 and later, use the .deb: the AppImage cannot start there, because the system blocks the sandbox it needs.

Linux: Ubuntu 22.04 or later · x86_64 · SHA-256 checksums

After you install

On the first launch the app creates a workspace in ~/rysh-workspace and opens it, so a shell pane works straight away. Agents in panes use their own logins.

1

Open Rysh

Open the .dmg and drag Rysh to Applications, or install the .deb (or run the AppImage), then launch it.

2

Start in a pane

The first launch opens ~/rysh-workspace with a shell pane.

3

Open a project

Open a folder that holds a rysh.config.yaml to work in an existing rysh project.

Prefer the terminal?

The ry CLI is the same engine without the desktop shell — it runs over SSH, in a container, or anywhere you already live in a terminal. It is the private build; the open-source (Apache-2.0) build installs as rysh instead, and the two install side by side.

Private build (ry) · Homebrew
$brew install rysh-ai/rysh/ry
Private build (ry) · curl
$curl -fsSL https://rysh.ai/install.sh | sh
Open-source build (rysh) · curl
$curl -fsSL https://packages.rysh.ai/install-rysh.sh | sh

APT and RPM repositories (private build, package ry) are set up in the installation docs.

The APT repository and every .deb and .rpm package are signed with the rysh release signing key, primary fingerprint 7516 CA5C D0B1 A64E 5B4B  9F0D 6815 300A B56A 1364. The key changed in v0.2.12; check the key before you trust it.

Windows: use WSL2 for now

There is no Windows desktop app. For the rysh CLI on Windows, use WSL2 for now. Native Windows panes (ConPTY) are built and tested on macOS and Linux only; they have not been tested on Windows.

Inside WSL2 the Linux build runs unmodified:

$wsl --install -d Ubuntu