Find your way around the Ysra desktop app for macOS, Windows and Linux: where work runs, the rail and panel, and the pages for each task.

On this page

Ysra Desktop is the app that lets Ysra work on a folder on your own computer: you describe what you want, and Ysra reads the code, changes it, runs your checks and shows every step. Use it when the code should stay on your computer, or to start threads on your devices and in Ysra’s cloud from one window. This page maps the app; the pages linked below cover each task.

YOUR COMPUTER YSRA You ask a question, or a change Plan the work what to read, what to change Your folder Ysra reads, edits and runs your checks here Work out the next step from what was read, nothing more The change stays in your folder not committed, not pushed Review the result against what you asked 1 your request 2 steps to carry out 3 what was read 4 5 the result
Ysra plans and reviews; 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

A thread: what you asked, what Ysra did, and the finished change.

The rule#

Nothing is committed, pushed or deleted without you. On your computer, Ysra works only in the folder you opened, and anything that reaches outside it asks first.

Start here#

  • Install

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

  • Quickstart

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

  • Start a thread

    Where it runs, how much Ysra may do alone, and the model.

Where work runs#

Place What runs there Needs this app open? More
A folder on this computer Ysra’s commands, contained to the folder Yes Start a thread
A folder on a device Ysra on the device itself No Devices & machines
A machine through a gateway One approved command at a time over SSH Yes, for a machine this computer reaches Machines
Ysra’s cloud A cloud machine of its own, on a repository or a cloud project No Code in Ysra’s cloud

The app at a glance#

The sidebar is a narrow rail of sections, each named under its icon, with a panel beside it for the section you’re in. The app opens on the section you left, if that is still there, or on Home.

The rail#

A count on a section marks something waiting for you: threads in Code, reviews in Mayz, visitors in Team, approvals in Routines. Cmd+1 to Cmd+9 go to the sections in the rail’s order.

Section What it’s for
Home What is going on, the message box, and what waits for you. See Home
Code Threads that work on a folder, a device or Ysra’s cloud. This is what these pages cover
Mayz Mayz reviews: what to fix, with evidence. Shown when Mayz reviews are on for the account. See Mayz reviews
Ask Questions answered with sources. See Ask
Learn Study notebooks, today's review and topics. See Learn
Team Your colleagues, and the questions visitors asked your public ones. See Colleagues
Routines Jobs that run on a schedule or on demand, with approvals. See Routines
Library Memory, files, and rules & instructions. See Library
Machines Every machine the workspace’s gateways reach. See Machines
Runbooks Procedures kept once and run on any machine. See Runbooks
At the foot of the rail What it does
The bell Counts your unread notices: what your routines did, such as a run that failed or waits for your approval
Help (Cmd+/) Opens a panel on the right, from every screen, that answers questions about Ysra and this account. See Help
Your account Settings (Cmd+,), Get the apps (the Phone app and the Command line (CLI)), and Appearance (Match System, Light, Dark)

The panel#

At the top of the panel is the workspace switcher, as in the web app: everything in the panel belongs to that workspace. Open it to switch workspace, choose New workspace, or Files & settings for the workspace’s files and settings.

The panel’s head has Back (Cmd+[), Forward (Cmd+]), search (Cmd+K, “Jump to a thread, chat, routine, or action…”) and Hide the panel (Cmd+\). The first row starts something new (Cmd+N): New thread in Home and Code, New review in Mayz, New chat in Ask, New routine in Routines.

Section The panel shows
Home Needs you (each thread with what it waits for), Running and Earlier (the last 8, then Show N more)
Code Filter threads, and Time, Folder or Device to group them. Time shows Needs you, Running and Earlier; Folder and Device show Needs you first, then each folder or device with its threads
Ask Answering and Earlier
Routines Needs you (runs waiting for your approval), then Routines
Team Team and Visitor questions
Library Memory, Files and Rules & instructions
Machines and Runbooks One line about the section; the panel starts hidden

Every group and folder folds away when you click its name, and the app remembers it on this computer.

At the foot of the panel What it does
A pill such as “3 devices · 2 waiting” Opens your devices: This computer, each device with how many threads wait or whether it’s offline, and Ysra cloud when you have cloud threads. Click one to show only its threads; + starts a new thread there
Invitations and the low-credits line Just above the pill
A docs link, such as How Code works The docs page for the section (in Library, in the page’s header)
Verify the email address you@example.com: open the link in the mail that was sent to it. Shown until the email is verified. Send the link again sends a new one (Sent. It can take a minute to arrive.)

Home#

Home opens with the date (and the workspace’s name, when you have more than one), a greeting such as “Good morning, Sam”, and chips: how many Routines are running, how many colleagues are public, and the credits left. The message box comes next: type there to start a Code thread. See Start a thread.

Under the box Shows
Waiting for you · N A card for each thing that needs you: 1 to approve for a routine’s run, A visitor needs a person for a public colleague, a watched site that went down, a thread with a question
A card per part with something to say Ask conversations today, Visitor questions this week (“N answered by your colleagues”), Routines on with the next run and the last runs, Files Ysra knows
What happened lately Newest first

A part with nothing to say isn’t shown.

Ask#

Ask with no chat open shows What do you want to know? and the same message box: attach files, dictate, and two choices in the box’s row. Colleague chooses who answers (Ysra, or one of your workspace’s colleagues), and the second chooses Answer or Deep dive. A colleague’s starter questions sit under the box. See Ask.

Under the latest answer, Take this further: offers Hand to Code, which turns the conversation into a brief for a Code thread. See Hand an answer to Code. Where an answer fits a routine, a card for one appears under it by itself.

Team#

Page Holds
Team Cards with Chat and Configure, and + Hire. See Colleagues
Visitor questions What people outside your team asked your public colleagues. See Public link

Library#

Library opens with a header: Library, your account’s domain and Ysra’s release, and a link to the docs for the open page, such as How memory works. It keeps Memory, Files and Rules & instructions, which holds the rules every Code thread loads. See Rules & instructions.

Settings opens as a page; ← Back or Esc returns. See Settings.

Working with Ysra#

Your changes#

Questions about your computer#

In a thread on a folder, you can ask about the rest of the computer:

What's taking up space on my disk?

With Settings → Code → Let Ysra look at this computer on, Ysra looks, read only: it never installs, changes or deletes anything there, and doesn't use the network for it. For storage, it measures the disk and what fills it. On a Mac, folders macOS protects are included only if you gave Ysra Full Disk Access. Ysra works on the computer only while the app is open.

With the switch off, Ysra tells you where to turn it on. In the CLI, type /computer look on. See Settings.

Beyond this folder#

What Ysra promises on your computer#

Promise Detail
Only the folder you opened Ysra works there and nowhere else. See Start a thread
Contained commands On macOS and Linux, commands are contained to the folder; anything that reaches outside your computer asks first, every time. On Windows, see Windows
Secret files Never read
Exact undo Or a refusal, never a guess. See Undo

The details are in Security on your computer, on the Platform tab.

YsraDocs