Download and install the Ysra desktop app on macOS, Windows or Linux, get past first-launch warnings, and take your first three steps.

On this page

Ysra Desktop is the app that lets Ysra work on folders on your own computer and, on a plan with cloud, start threads in Ysra’s cloud. The current version is Desktop 1.23.1. This page covers downloading, installing and the first launch; for updates and removal, see Update and uninstall.

Downloads#

The links always point at the latest release.

System File
macOS, Apple silicon (M1 and later) Ysra-mac-arm64.dmg
macOS, Intel Ysra-mac-x64.dmg
Windows, 64-bit Ysra-win-x64.exe
Linux, Debian and Ubuntu, 64-bit Ysra-linux-amd64.deb

Not sure which Mac you have? Apple menu → About This Mac. “Chip: Apple M…” means Apple silicon; “Processor: Intel” means Intel.

macOS#

  1. Open the .dmg.
  2. Drag Ysra into Applications.
  3. Open Ysra from Applications.
macOS asks Why Answer
“Ysra is an app downloaded from the internet. Are you sure you want to open it?” The first launch of any downloaded app. Ysra is signed and notarized with Apple Open
Whether Ysra may access a folder under Documents, Desktop or Downloads The first time Ysra works in one Allow it for the folders you want Ysra to work in
Whether Ysra may use the microphone The first time you dictate or use voice Allow it, or type instead

Windows#

  1. Run Ysra-win-x64.exe.
  2. Follow the installer. It installs for your user, lets you choose the folder, and adds Open in Ysra to the right-click menu for folders.

The Windows installer isn’t signed yet, so SmartScreen shows “Windows protected your PC” with an unknown publisher. Choose More info → Run anyway.

Note

On Windows, commands aren’t contained by default, so each one asks first. Ysra can run them contained inside WSL instead. See Ysra Desktop on Windows.

Linux (Debian, Ubuntu)#

sudo apt install ./Ysra-linux-amd64.deb

Start it from your applications menu, or run ysra-desktop. The package never installs a command called ysra, so it can sit next to the CLI.

To let Ysra run commands, the computer also needs bubblewrap, socat and ripgrep:

sudo apt install bubblewrap socat ripgrep

Without them Ysra still reads and edits files; it just doesn’t run commands.

First launch#

While the app opens, the window says Starting…. If it stays empty, see Troubleshooting.

  1. Sign in with Sign in to Ysra with your browser, then Allow in the browser. Use a password instead works too; if you already use the CLI on this computer, choose Use the ysra CLI login.
  2. Choose a folder on the line under the message box. Any folder works as it is, with or without Git; sending your first message trusts it on this computer.
  3. Ask or describe a change, and press Enter.

Continue with the desktop quickstart.

If it doesn’t work#

Symptom See
The window stays empty Troubleshooting
Signing in doesn’t finish Troubleshooting: sign-in
I can’t run commands on this computer yet (Linux) Troubleshooting: commands are blocked
YsraDocs