Apps and your computer

Chat, tasks and integrations work right in the browser, with nothing to install, and the agent opens websites in the cloud. The apps add what a browser cannot:

• on a computer the agent works on your machine: it opens its own browser with your website logins, works with files in the folder you choose and runs commands;
• on a phone your chats, tasks and notifications are at hand.

Where to download

Every version is on the download page.

Download the app only from the download page or an app store. Do not open installer links from emails or messengers.

How to install the app on a computer

On Windows, do not start the app with Run as administrator: it runs only with ordinary user rights and refuses to start. Run a command that needs administrator rights in a separate PowerShell window.

How to install the app on a phone

Open the download page on your phone: the first button is your system's store, App Store for iPhone and RuStore or Google Play for Android. Install the app and sign in to the same account.

If the App Store says the app is not compatible with your iPhone, it needs iOS 16.4 or later. Without updating iOS, use the web version in the phone's browser: the chats and tasks are the same.

How to keep the app up to date

On a computer

The app checks for updates and downloads them in the background. When a new version is out, a New version card appears in the account menu, and an arrow mark at the bottom of the sidebar. Press Update, and once the version is downloaded, Update & restart: the app restarts and your chats and work stay where you left them. The update window includes a What’s new list.

• On Mac and Linux a downloaded update can also install itself while the app is in the background; the line under the button then reads Installs while the app is in the background. The button only speeds it up.
• On Windows the update installs only from the button.

To check by hand: Settings → Apps → App version → Check for updates. The same place has Copy version info: send it to support if something is wrong.

On a phone

Updates come through the store you installed the app from. Turn on automatic app updates in the App Store, RuStore or Google Play.

In the browser

The web version is always up to date; there is nothing to do.

If it says Update required

The Update required window means your version is no longer supported: an old version cannot work with the service. The window cannot be closed, but no data is lost. Press Update (on a phone: Update in App Store, RuStore or Google Play).

If the button does not help, read the line under it:

The installer from the download page installs over the old version: there is no need to remove the app first, and your sign-in and settings are kept.

Where the agent works: the cloud or your computer

A computer connects by signing in: install the app and sign in to your account in it. No separate code is needed. Then, next to the chat's input field, there is a Where to work choice: In the cloud or your computer.

• In the cloud: isolated, with no access to your files. The agent opens websites in a cloud browser with its own profile and logins. Good for research, reports, public pages and work with integrations.
• A computer: files in the chosen folder, that computer's apps and commands, its browser and network. This is what you need where the cloud cannot reach: a supplier portal, a government service for business, an internal admin panel, a site with no API, a page behind the corporate network.

A connected computer can also be chosen from the web version: the agent works on it as long as the app is open there. A computer is connected to one account, the one signed in to the app on it. What the agent may do on the computer without asking is set in Settings → Capabilities: How the agent changes your data.

The selected computer does not change by itself when the link drops. While it is away, the agent does in the cloud what needs no computer, and the files on the computer are out of its sight; for a step that needs the computer, the agent says it is waiting for it. To work in the cloud, choose In the cloud explicitly: local files are not moved to the cloud by that choice.

An office computer that runs all the time

If the agent should work on a computer nobody sits at, open Settings → Devices & sessions → This computer on it and turn on:

• Launch at login: the app starts with the system and keeps the link;
• Keep this computer awake: blocks idle sleep. Closing a laptop's lid or choosing Sleep still puts it to sleep, so keep it plugged in with the lid open.

The same group has Connect phone: scan the QR code with your phone, and it can read and reply in this computer's chats. The list of connected phones and the Revoke access button are there too.

Scheduled tasks on your computer

Where a task runs is set by its Where to work line. A task set to In the cloud does not depend on your computer. If a computer is selected and it is offline when a run is due, the task waits for it:

• its schedule line shows Waiting for the computer, and you get a notification;
• once the computer is back online, the task runs once, even if several runs were missed meanwhile;
• it never moves to the cloud or another computer.

Your computer and colleagues

Your computer works only for your account. In a group chat where another person sits besides you, the agent does not work with your computer, browser, connected services or personal memory on anyone's messages, your own included. For the agent to work on a colleague's computer, the colleague installs the app there and signs in to their own account.

The agent browser on your computer

There is no "turn on the browser" button. Choose the computer under Where to work and say in plain words what to do: "open the supplier portal and export the stock levels", "sign into the account and file the request". The agent launches the browser itself when the task calls for it.

The first time, an Agent browser dialog appears: click Allow. Your choice is kept for 90 days. A browser window then opens on your screen, and a Local browser live stream appears in the chat, so you see every click even with the window minimised.

In the browser the agent opens pages and follows links, fills and submits forms, pulls numbers, tables and statuses off pages, uploads and downloads files, and takes screenshots. The result comes back as an answer in the chat, plus a file if you asked for a table or a report.

The agent's screen and control

At the top right of the chat there is a monitor button with the tooltip Agent's screen. On a computer it opens a panel on the right: the agent's screen, its browser, changes and running previews; on a phone the agent's screen opens full screen. The button lights up while the agent works on the screen. Group chats do not have it.

• Watching: the agent works and you see its steps. Take control hands the screen to you.
• You're in control: the screen is yours and the agent waits. Stop controlling gives the screen back to the agent.

When the agent needs a step from you, a card appears in the chat: Sign-in needed, A check needs passing (a CAPTCHA), Payment needs confirming, and the screen button gets a dot with the tooltip Needs your attention. Press Open page, take the step in the same browser window and press Done: the agent checks the page and continues.

Signing in to websites

The agent first checks whether its profile is still signed in. When a site asks you to sign in, you enter the login, password, verification code, CAPTCHA or passkey yourself; the agent neither sees nor types them. The sign-in is kept in the agent's profile until the site asks again.

• Marketplaces. Data and actions available through an API come from integrations. If the API does not cover the action, the work can go through the browser on your computer; whether it succeeds depends on your access in the seller account and the site's checks.
• Banks. The agent works with statements and payments through the bank connection in integrations. Bank agreements usually prohibit sharing the login and password with third parties, so you sign in to online banking yourself.
• The agent does not obey website content. Text on a page is data to it: it does not follow instructions found on a third-party site or share secrets at their request.

Which browsers work

Chromium-based browsers only: Google Chrome, Microsoft Edge, Brave, Vivaldi, Opera, Yandex Browser, Chromium and Chromium-Gost. The app takes your saved choice, then a supported system default, then another installed browser from the list; you can ask the agent to open a particular one. Safari and Firefox are not supported.

For sites with GOST encryption (the Federal Tax Service cabinet for companies, the EIS procurement cabinet), ask the agent to open Chromium-Gost: CryptoPro CSP and the CryptoPro plug-in must be installed on the computer, and you enter the token PIN yourself.

Local pages and addresses

The agent browser opens HTML files from the working folder the agent has access to and local servers such as http://localhost:5173 or http://127.0.0.1:8080, with no separate permission. If the page needs HTTP for modules, data requests or paths such as /assets/, the agent can start the project's dev server and check its address.

For another computer or service on your local network, such as 192.168.1.20:8080, and for a site of a work or city network whose name leads into the internal network on this computer, the agent offers an access card. Approve it in the app on the computer running the browser: the card allows the site by its whole name, such as sudir.mos.ru. The permissions are also listed under Settings → Capabilities → Agent browser → Local addresses.

If you close the browser window, the agent asks you to open it again on its next step. Quitting the app closes this window too.

What the computer statuses mean

The status and a hint on what to do are shown in Settings → Devices & sessions under the computer's name.

No link while the computer is on

The line under the status says where the connection broke:

• this computer's network cannot reach the server: check the internet connection; the app reconnects by itself;
• the proxy does not let the connection through or requires a sign-in: check the proxy settings or ask the network administrator to let connections to the server through without a proxy sign-in;
• a proxy this version cannot connect through: update the app or set an HTTP or HTTPS proxy;
• the server certificate could not be verified: ask your administrator to check the computer's trusted root certificates and whether an antivirus or corporate proxy intercepts secure connections;
• the connection drops right after connecting: no need to check the computer's network, the app reconnects by itself. If the link is not back within a few minutes, restart the app.

If the browser does not start

• “This action needs a newer version of the desktop app. Install the update and restart the app.” Repeating the same action before updating will not help; other available actions may still work.
• “The browser did not become ready for control in time. Check the app on the computer where the browser is being launched.” Most often a dialog in the browser window is waiting for an answer: answer it and repeat the request.
• “The browser closed while starting. Check that it opens normally, or choose another browser.”
• “The agent's port is held by a program the app did not start. Close it and try again.” Retrying will not help while that program holds the port; restarting the app also works.
• “This browser is not supported. Choose an installed Chromium-based browser (Chrome, Edge, Yandex Browser or Brave), or install one.” The agent does not automate Safari or Firefox.
• “This browser is not installed on the computer. Install it or choose another browser.”

If your antivirus flags the app

With your permission the app launches a browser, runs commands and controls the screen. An antivirus such as Kaspersky may take that behavior for something suspicious.

1. Make sure the app was downloaded from the download page.
2. Do not turn the antivirus off entirely. Add the app to its trusted programs following your antivirus's instructions, or report it to the vendor as a false detection.
3. If that does not help, write to support: attach the antivirus report and the version info from Settings → Apps.

How to log out and uninstall

• Closing the window is not quitting: the app stays in the Dock or the tray and keeps tasks going in the background. To quit fully, use Quit Samreshuuu in the app menu or the tray.
• Log out: Log out in the account menu. The sign-in on this device ends, while chats, agents and memory stay in the account.
• Uninstall: on Mac drag the app from Applications to the Trash; on Windows remove it from the Windows app list. The Windows uninstaller offers to remove the app's data as well.

After uninstalling, the computer stays in the account's list. To close its access, open Settings → Devices & sessions and press Revoke on that computer. Access can be restored only from the computer itself, by signing in again.

Devices & sessions

Settings → Devices & sessions holds:

• This computer (in the desktop app) and Other computers (in the browser and on a phone this group is called Computers): status, Rename, Switch off and Revoke;
• Sign-ins: where your account is signed in. Revoke ends one sign-in, Revoke all others ends every one except the current.

If you do not recognize a sign-in, end it and change how you sign in. More on protecting your account: Data and security.