Repository navigation
Releases
Ru 0.1.4-preview.1
Separate per-user Windows x64 Desktop and CLI packages, with matching self-contained Hosts.
Updates: Settings > About, ru update, or /update in TUI. Stable is the default; Preview is opt-in.
These initial packages are unsigned. SHA256SUMS.txt verifies integrity, not publisher identity.
See docs/operations/distribution-and-updates.md for installation, recovery and verification limits.
Highlights
- Attach any file: small text is inlined, everything else is sent as a workspace path, and a file from outside the workspace is copied into
.ru/attachments.readnow extracts PDF, Word, Excel, PowerPoint and OpenDocument text, and every failed read tells the model which command opens the file. - The advisor belongs to each session; a new session starts without one.
- Provider keys are checked when saved and their status is shown; Models.dev providers use the protocol their SDK names, so Anthropic-compatible gateways such as MiniMax work.
- Terminal UI: a live Todos checklist beside chat (
Ctrl+T), arrow-key question choices, saved messages shown before replay finishes, quieter tool receipts and a steady caret. - Breaking: runs no longer park for Continue (ADR 0048), a denied approval settles only that call, and the subagent and Host concurrency ceilings are removed.
Full list: CHANGELOG.md.
Ru 0.1.3-preview.1
Separate per-user Windows x64 Desktop and CLI packages, with matching self-contained Hosts.
Updates: Settings > About, ru update, or /update in TUI. Stable is the default; Preview is opt-in.
These initial packages are unsigned. SHA256SUMS.txt verifies integrity, not publisher identity.
See docs/operations/distribution-and-updates.md for installation, recovery and verification limits.
Highlights
- Fewer model round trips per coding run: proportional todos, batched reads/edits/checks, catalog-based output cap (no more mid-call truncation at 8,192 tokens) and leaner tool results.
- PowerShell output keeps Vietnamese and other non-ASCII text intact.
- Reopened sessions show attached files as chips with the typed message instead of the raw
[Attached file: …]envelope. - Held, truncated and failed steps now report provider usage, so cost and context meters are complete.
- Breaking: legacy Broker v1 execution path, the text-selection tool calling mode and the
supersedesterminal argument are removed.
Full list: CHANGELOG.md.
Ru 0.1.2-preview.1
Ru 0.1.2-preview.1
Preview release for Windows x64, with separate self-contained Desktop and CLI packages.
Highlights
- Run independent sessions in the same workspace and return to background runs without stopping them.
- Connect user-configured stdio MCP servers, with Broker-owned process lifetime and per-server/tool approvals.
- Let vision-capable models inspect workspace PNG, JPEG and WebP images through the existing read tool.
- Improved WinUI workspace sidebar, context usage breakdown, file previews, command palette and provider settings.
- Refined terminal chat rendering, Markdown tables, tool groups and failure explanations; improved Unicode, paste and recovery behavior.
- More reliable context compaction, provider continuations and concurrent run handling; Cancel remains idempotent when the worker commits during tool shutdown.
- Security fixes for workspace Stop-hook trust, remembered MCP approvals, skill hard links and terminal approval identity.
Install and update
Choose Ru-Desktop-0.1.2-preview.1-win-x64-Setup.exe for the native app or Ru-CLI-0.1.2-preview.1-win-x64-Setup.exe for terminal use. ZIPs contain the corresponding portable files. Windows 10 build 17763 or newer, x64; no .NET SDK required.
Existing users can update from Desktop Settings > About > Updates, ru update, or /update in the TUI. Select the Preview channel to receive this release. Stable remains the default preference, with no Stable release published yet.
The packages are unsigned. SHA256SUMS.txt verifies download integrity, not publisher identity. Terminal commands run as your Windows account without OS-level filesystem or network confinement.
Full changelog · Installation and recovery
Verification
- 7,751 .NET tests across 13 projects passed; Python 3.11/3.12/3.13 and the TypeScript SDK passed CI.
- Release builds and installer install/update/uninstall checks passed on a disposable Windows runner.
- Both packaged Hosts booted, authenticated and shut down successfully.
- All five uploaded assets were downloaded and their SHA-256 digests verified; both ZIP layouts and product versions were checked.
Ru 0.1.1 Preview 1
Ru 0.1.1 Preview 1
Desktop improvements
- Refine New Chat with a muted green, blue and violet fill; simplify session titles and keep rounded hover states.
- Give expanded thinking the full conversation reading width.
- Improve Markdown tables and code blocks: responsive width, clearer spacing, horizontal scrolling for long code, and complete table-cell text.
- Stabilize live/replayed activity ordering and join contiguous text chunks correctly.
- Replace the unbounded task panel with a compact, independently scrolling shelf driven by the latest session plan.
- Hide routine internal run/model-step status above the composer and simplify the New messages action.
- Show the title-bar Update action only when a compatible update exists; application information and update controls live in Settings > About.
CLI and agent fixes since the first preview
- Add
ru uninstallfor registered CLI installations and document one-command bootstrap with download/update progress. - Keep GUI/CLI build versions aligned; this release reports
0.1.1-preview.1. - Repair repeated shell-approval matching while preserving exact scripts, workspace/network scope and deny/ask precedence.
- Improve provider tool guidance, prompt/context budgets, paged tool output and explicit blocker reporting.
Installation and updates
Windows x64 Desktop and CLI are separate packages, each including its matching self-contained backend. Use the Setup executable to install, or the ZIP for a portable copy. The .NET SDK is not required.
Preview is opt-in: select Preview in Settings > About > Updates, or use ru update --channel preview. Stable remains the default. The original 0.1.0-preview.1 desktop keeps update settings under General.
The installers are unsigned. SHA256SUMS.txt verifies downloaded file integrity. Back up your Ru profile before deliberate downgrades; rollback to an older database version is not guaranteed.
Ru 0.1.0-preview.1
Ru 0.1.0-preview.1
First Windows x64 Preview with separate Desktop and CLI installers and explicit updates. Each product bundles a matching self-contained backend; no .NET SDK is required to run it.
Downloads
- Desktop:
Ru-Desktop-0.1.0-preview.1-win-x64-Setup.exe - CLI / TUI:
Ru-CLI-0.1.0-preview.1-win-x64-Setup.exe - ZIP packages are also provided.
SHA256SUMS.txtlists the asset checksums.
Installers run per user and allow choosing the installation folder. Desktop and CLI use separate application folders and share sessions/settings under %LOCALAPPDATA%\Ru. Uninstall preserves that profile. The CLI installer adds its own directory to the user PATH; an existing ru earlier on PATH may still take precedence (where ru shows which command is selected).
Updates
Install CLI from Command Prompt:
curl -fsSL https://raw.githubusercontent.com/OniAntou/Ru-Agent/dev/scripts/install.ps1 -o ru-install.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File ru-install.ps1 -Channel PreviewThe script downloads and verifies the CLI package, installs for the current user without opening a setup wizard, and adds ru to the user PATH. Open a new terminal after installation.
- Desktop: Settings → General → Updates.
- CLI:
ru update --channel preview --check, thenru update --channel previewto install an available successor. - TUI:
/updatechecks;/update --yesinstalls and exits.
Stable is the default channel. Select Preview to receive prereleases. This is the first Preview; no newer release is available yet. Source builds must be rebuilt instead of using the installed-product updater.
Updates verify the official release origin, size and SHA-256 and refuse unfinished runs before stopping an idle Host. Installation waits for the caller to exit; it does not terminate other applications.
Preview limits
Verified on GitHub Actions: 6,284 .NET tests, Python/tooling guards, the release build, production install/update/uninstall with PATH/profile preservation, and Host startup/idle shutdown from both packages. The upgrade smoke uses a synthetic older marker with the candidate binaries; older-release binary compatibility is not yet established.
These installers are unsigned; Windows may display a publisher warning. Checksums verify integrity, not publisher identity. Native GUI update-button/restart acceptance and a download/install of a published successor remain pending. Recovery does not promise transactional rollback or database downgrades.
See installation, updates and recovery for details.