Install Ru¶
Ru runs on Windows 10 (build 17763) or newer, x64. It ships as two separate products: the desktop app and the CLI, which is the terminal UI. Each carries its own matching backend, so you do not need the .NET SDK unless you build from source.
Caution
Ru is a Preview and the initial installers are unsigned, so Windows may warn before running them. No Stable release is published yet; the CLI command below selects the Preview channel for that reason.
Install the desktop app¶
- Open the Releases page and download
Ru-Desktop-VERSION-win-x64-Setup.exe. - Run it. It installs for your user under
%LOCALAPPDATA%\Programs\Ru Agent Desktopwithout administrator rights and adds a Start-menu shortcut. - Start Ru from the Start menu.
Install the terminal UI¶
- Open Command Prompt. PowerShell works too.
-
Run the installer:
powershell -NoProfile -ExecutionPolicy Bypass -Command "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/OniAntou/Ru-Agent/dev/scripts/install.ps1'))) -Channel Preview" -
Open a new terminal and run
ru.
The script downloads a compatible release, checks its SHA-256 digest, runs the installer silently and
adds the CLI to your user PATH. It never fetches from a URL a model supplies. To read the script
before running it:
Invoke-WebRequest https://raw.githubusercontent.com/OniAntou/Ru-Agent/dev/scripts/install.ps1 -OutFile .\install.ps1
# Inspect install.ps1 before running it.
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -Channel Preview
You can also download Ru-CLI-VERSION-win-x64-Setup.exe or a portable ZIP from the Releases page. If
ru starts a different copy than you expect, such as a source checkout, where ru shows which one runs.
Where Ru keeps your data¶
Sessions, settings and workspace state live in your Ru profile under %LOCALAPPDATA%\Ru, outside the
install folders. API keys are stored in Windows Credential Manager. Updating or uninstalling the
application leaves the profile and your keys in place.
Keep it up to date¶
- Desktop: open Settings → About → Updates, choose Stable or Preview, then Check for updates. Ru also checks at startup and every 30 minutes while it is open, but it never downloads or installs anything on its own. Install and restart does the update with a progress bar you can cancel.
-
Terminal:
ru update --check ru update --channel preview ru update --yes ru --versionInside the terminal UI,
/updatechecks and/update --yesinstalls.
An update refuses while a run is unfinished, including one waiting for your approval. Finish or cancel
it first. If two different Ru versions are open, one reports host_version_mismatch; close the other.
Uninstall¶
For the CLI, run ru uninstall and confirm in the wizard it opens (close other CLI windows first).
This removes the CLI files and its PATH entry. It keeps your sessions, API keys and the shared Ru
profile.