Install the desktop app
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#
- Open the
.dmg. - Drag Ysra into Applications.
- 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#
- Run
Ysra-win-x64.exe. - 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.
- 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.
- 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.
- 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 |
Related#
- Desktop quickstart: sign in, open a folder, first change.
- Ysra Desktop: what the app does and where everything is.
- Update and uninstall: newer versions and removing the app.
- Install the CLI: the same work from a terminal.