SARAS controls: what works and how to use it

Mobile dashboard · Windows download

Connect your phone

  1. Install and open the Windows Companion. Keep the laptop awake and connected to the internet.
  2. Sign in to SARAS on your phone. Scan the laptop QR or choose the manual pairing-code option.
  3. Match the approval code and approve on the laptop and phone. Pairing links your account; it does not mean the laptop is online.
  4. Start account connection on the laptop. In My Devices, wait for Online, then choose Control laptop and Enable access.

Online means the cloud received a recent authenticated laptop heartbeat. Access enabled/disabled is a separate permission. Offline detection takes about 15–20 seconds without a heartbeat; it is not instantaneous. If the phone cannot reach the server, status is unavailable rather than falsely online.

Commands without an AI key

My PC → Choose an action manually → select an action → enter its fields → review → approve. An AI key is not required for this manual path.

To close Calculator: choose List visible windows, copy its exact title, then select Close exact window and approve. This sends a normal close request; it does not force-kill apps or dismiss save dialogs. The phrases “open calculator” and “close calculator” also prepare direct proposals. A bare “close” asks which app unless the most recent completed action opened Calculator.

Desktop keyboard, window controls, clipboard and power actions need the corresponding local Companion permissions. File actions stay inside folders explicitly shared on the laptop. Features can fail if the operating system or hardware does not support them.

Online and offline requirements

The online mobile controller requires internet on both phone and laptop, a running Companion, an authorized account and device pairing. A powered-off or sleeping laptop cannot be controlled. The installed PWA shell can open offline but cannot execute remote commands offline.

Manual Windows actions and installed Windows voices do not inherently need an AI key. Browser speech recognition can depend on a browser cloud service. Local speech recognition requires its installed runtime/model. General AI chat and ambiguous natural-language tasks require a configured provider and internet. Weather, web pages and searches also require internet. Personal voice packs are not automatically included in the public installer.

Sign-in and this-device app lock

Use a normal browser or installed PWA. Private browsing and clearing site data can remove the sign-in cookie. Sessions remain signed in for up to 30 days of inactivity while provider authorization remains valid. Logout, provider revocation or expired credentials can require sign-in again.

Settings → App lock on this device → choose a separate 6–12 digit SARAS PIN. It is checked by the server and is never your Google password. Leaving the app locks this session; inactivity also locks it after 15 minutes. If you forget this session PIN, sign out and sign in again with your identity provider. Each signed-in device has its own lock.

Available action catalog

This catalog describes supported actions, not a guarantee that every device supports every action. Review the actual app result and execution log.

ActionPurpose and limitationsFieldsPermission
Desktop Scroll StartContinuous foreground scrolling until Stop, focus change or connection loss; no page-end detectionwindow, directionReview and sensitive approval
Stop ScrollStop current/pending continuous scrollingNo extra fieldsReview and approve
Current TimeRead this laptop local date, time and UTC offsetNo extra fieldsReview and approve
Weather CityFetch latest model-based city weather from Open-Meteo; sends city name to providercityReview and approve
Clipboard ReadRead up to 4000 copied characters into private cloud command log, on explicit request onlyNo extra fieldsReview and sensitive approval
Clipboard SaveSave current copied text to a new shared .txt file; no overwritefolder, pathReview and sensitive approval
Clipboard PasteType reviewed clipboard text (1–500 visible characters) into exact foreground window; requires hash from clipboard_readwindow, expected_sha256Review and sensitive approval
Desktop ScrollScroll exact foreground window up/down, 1–1000 paced wheel stepswindow, direction, stepsReview and sensitive approval
Youtube SearchOpen YouTube search results for a reviewed query in the default browserqueryReview and approve
Bluetooth OnRequest Bluetooth radio on; requires local power/radio consent and Windows permissionNo extra fieldsReview and sensitive approval
Bluetooth OffRequest Bluetooth off; Bluetooth keyboard/mouse may disconnectNo extra fieldsReview and sensitive approval
List AppsList installed current-user Start application names, up to 500No extra fieldsReview and approve
List WindowsList visible window titles onlyNo extra fieldsReview and sensitive approval
Close WindowRequest normal close of one exact unique window title, preserve save dialogswindowReview and sensitive approval
Focus WindowRestore and focus an exact unique visible window titlewindowReview and sensitive approval
Minimize WindowMinimize an exact unique visible window titlewindowReview and sensitive approval
Maximize WindowMaximize an exact unique visible window titlewindowReview and sensitive approval
Copy PathCopy file/folder within shared root, no overwrite, max 100 MB/2000 entriesfolder, path, new_pathReview and sensitive approval
Volume ControlSystem volume up/down or mute toggleactionReview and sensitive approval
Set BrightnessSet supported laptop display brightness, 10–100 percentpercentReview and sensitive approval
Take ScreenshotSave primary-screen screenshot as a new PNG in a shared folder; no image uploadedfolder, pathReview and sensitive approval
Move PathMove or rename a file/folder within its shared root, no overwrite, max 100 MB/2000 entriesfolder, path, new_pathReview and sensitive approval
Delete PathDelete a file/folder by moving it to .saras-recovery within the same shared root, max 100 MB/2000 entriesfolder, pathReview and sensitive approval
Search TreeRecursive filename search in a shared folder, capped at 5000 entries/3 seconds/100 matchesfolder, path, queryReview and approve
Desktop CloseRequest normal close of the exact foreground window; preserve save prompts, never force killwindowReview and sensitive approval
Inspect DesktopRead foreground window title, primary screen size and pointer coordinates; no screenshot/contentNo extra fieldsReview and sensitive approval
Desktop TypeType up to 500 visible characters into the exact foreground window; no focus switchingwindow, textReview and sensitive approval
Desktop KeyPress enter/tab/escape/backspace/arrows/home/end in exact foreground windowwindow, keyReview and sensitive approval
Desktop ClickSingle left click at primary-screen coordinates in exact foreground windowwindow, x, yReview and sensitive approval
Shutdown PcShut down this PC after a cancellable 30-second grace period; unsaved work may block shutdownNo extra fieldsReview and sensitive approval
Restart PcRestart this PC after a cancellable 30-second grace periodNo extra fieldsReview and sensitive approval
Cancel ShutdownCancel a SARAS shutdown/restart countdownNo extra fieldsReview and approve
Wifi OffRequest Wi-Fi radio off using Windows radio permission; remote connection may be lostNo extra fieldsReview and sensitive approval
Wifi OnRequest Wi-Fi radio on using Windows permission; use the laptop locally if disconnectedNo extra fieldsReview and sensitive approval
StatusRead OS statusNo extra fieldsReview and approve
List NotesList SARAS notesNo extra fieldsReview and approve
Write NoteCreate a new note; no overwritesname, textReview and approve
List FilesList a user-shared directoryfolder, pathReview and approve
Read FileRead a text file and its sha256folder, pathReview and approve
Verify FileRead a shared text file and fail unless its exact UTF-8 bytes match the approved SHA256; no file content returnedfolder, path, expected_sha256Review and approve
Create FileCreate a text/code file without overwritingfolder, path, textReview and approve
Replace FileReplace an existing text file only if its hash matches; preserve backupfolder, path, text, expected_sha256Review and sensitive approval
Make FolderCreate a folder inside a shared directoryfolder, pathReview and approve
Rename FileRename a file without overwritingfolder, path, new_pathReview and sensitive approval
Trash FileMove a file to SARAS recovery folder; no permanent deletionfolder, pathReview and sensitive approval
Open AppOpen calculator, notepad, paint, explorer, task_manager, vscode, chrome or edge; or an exact installed name from list_appsappReview and approve
Open FolderOpen an explicitly shared directory in Windows Explorerfolder, pathReview and approve
File InfoGet text file size, last-modified time and current sha256folder, pathReview and approve
Copy FileCopy a text/code file within the same shared folder; never overwritefolder, path, new_pathReview and approve
Search FilesFind filenames in one shared directory (not recursive); does not read contentsfolder, path, queryReview and approve
Open UrlOpen an external HTTPS website in the default browserurlReview and approve