---
title: Ysra Desktop
description: The desktop app for macOS, Windows and Linux — work on a folder on your own computer, follow every step, and approve what matters in a window.
sidebar_title: Overview
---

The desktop app lets me work on a folder on your own computer. You describe
what you want; I read the code, change it, run your checks and show every step.
Nothing is committed, pushed or deleted without you.

> Diagram: I plan and review; the reading, editing and running happen in your folder, and the change stays there until you decide.

![A finished thread: stretches of work with notes between them](../assets/screens/desktop/thread.webp){ width="1440" height="891" }
/// caption
A thread: what you asked, what I did, and the finished change.
///

## Start here

<div class="cards" markdown>

- [**Install**](../install/desktop.md)

    Downloads for macOS, Windows and Linux, and first launch.

- [**Quickstart**](quickstart.md)

    Sign in, open a folder, first change, in five minutes.

- [**Open a folder**](open-folder.md)

    The trust sheet, folders without Git, parallel copies.

</div>

## The app at a glance

The sidebar has five modes:

| Mode | What it's for |
|---|---|
| **Home** | What needs you, what's running, what just finished |
| **Build** | Threads that work on a folder. This is what these pages cover |
| **Ask** | Questions answered with sources |
| **Automations** | Jobs that run on a schedule or on demand, with approvals |
| **Library** | Experts, memory and files |

In **Build**, threads are grouped by folder. **Needs you** and **Running**
filter the list; **Search or jump to…** (++cmd+k++) finds anything.

## Working with me

<div class="cards" markdown>

- [**Ask and change**](ask-and-change.md)

    Questions, changes, briefs, attachments, steering.

- [**The working timeline**](timeline.md)

    How to read what I'm doing, step by step.

- [**Approvals and auto mode**](approvals.md)

    What I always ask first, and what auto mode covers.

- [**Stop and continue**](stop-continue.md)

    Stopping, pausing, and picking up again.

</div>

## Your changes

<div class="cards" markdown>

- [**Review the diff**](review.md)

    See exactly what changed, and comment on lines.

- [**Commit and push**](commit-push.md)

    New or existing branch, never forced, your CI read back.

- [**Undo my changes**](undo.md)

    Put everything back exactly as it was.

</div>

## Beyond this folder

<div class="cards" markdown>

- [**Getting the machine ready**](machine-setup.md)

    Missing tools, with your OK and nothing hidden.

- [**Devices and targets**](devices-targets.md)

    Work on servers and edge devices from this window.

- [**Troubleshooting**](troubleshooting.md)

    When something doesn't work, and where the record is.

</div>

## What I promise on your computer

- I work only in the folder you opened.
- Commands run contained to that folder; anything that reaches outside your
  computer asks first, every time.
- Your secret files are never read.
- Undo is exact.

The details are in [Security on your machines](../security.md), on the
Platform tab.