Skip to the form

Support

Short answers to what we're asked most. If yours isn't here, a person will reply.

What do I need to use R.I.V.E.R.?

Windows 10 or 11, 64-bit. Internet is only needed to activate the license and renew it at least every 60 days, check for updates and download the voice model and theme desktops once. The processor, memory and disk it needs are in the requirements.

Is there a free trial?

Yes: 7 days of the full Pro Edition, once per PC, from the program itself. No card needed.

Where's my key? I've lost it

It's in your purchase email (it starts with RIVER-); check your spam folder too. If you can't find it, at Recover my key we'll resend it to the email you bought with.

How many PCs can I use it on? How do I move it?

On 2 PCs at the same time. To move it, go to Settings › License and press “Free this PC” (at most 3 changes every 30 days; the program tells you from what date you can change again). A PC that hasn't connected for more than 60 days frees its slot automatically.

Does it work offline?

Yes. The license is checked online at least once every 60 days: offline it keeps working for up to 60 days and renews by itself when there's internet again.

It says “Connect to the internet” or “This PC's date looks wrong”

The first appears after more than 60 days offline: connect and press “Retry”. The second appears if the Windows date or time is wrong: fix them (or connect) and press “Retry”.

It won't let me open new terminals

The license isn't active (the trial ended or it's been offline for more than 60 days): press “Enter my key” in the notice at the top. Your open terminals keep working.

The Claude usage panel stays empty

It fills in as soon as Claude replies in a Claude terminal opened from R.I.V.E.R. (“+ New terminal” › Claude); sessions opened outside R.I.V.E.R. don't pass the data along. It only works with a Claude Pro or Max plan: with an API key, Claude doesn't provide that data. To hide it: Settings › Theme › “Show Claude plan usage”.

Which AIs does it work with? How do I set one up?

In Settings › General › “Set up your AI” (it also appears when you start) you pick one: Claude Code, Codex (OpenAI), GitHub Copilot CLI or Google Antigravity CLI. R.I.V.E.R. installs it in your user account, without administrator rights, and opens your browser so you can sign in. Then open it from “+ New terminal”. They're not included: each one is an independent service from its company, on your own account; Claude Code needs a paid Claude plan.

I use ChatGPT: does it work?

Yes, with Codex, OpenAI's agent, which runs in the terminal and is used with your ChatGPT account. It's not included: it's an independent service from its company. ChatGPT's chat doesn't open inside R.I.V.E.R. The “finished / asking for permission” alerts and the usage panel are Claude Code only.

“Set up your AI” stops halfway or won't let me sign in

Check you're online and open “Set up your AI” again. If the browser doesn't open, press “Open it from here” or look in the terminal for an address starting with https:// from your AI's company and paste it into your browser. If your account won't sign in, the cause is usually that AI's own service (for example, Antigravity needs a personal Google account: Google Workspace plans don't include it). If typing claude, codex, copilot or agy says “is not recognized as the name of a cmdlet”, close R.I.V.E.R. completely and open it again (if it persists, restart the PC); to check it's installed, type its name with --version (for example, codex --version). If it still fails, write to us below with a screenshot (no passwords or codes), or install it yourself with the steps in the questions below.

It doesn't tell me when my AI finishes

Those alerts only work with Claude Code. With Codex, GitHub Copilot CLI or Google Antigravity CLI you work the same way in their terminals, but without that alert or the usage panel.

How do I install Claude Code myself, without “Set up your AI”?

The easiest way is “Set up your AI”; this is in case that fails. Claude Code belongs to Anthropic, an independent service from R.I.V.E.R., with its own account and terms. It needs a paid Claude plan that includes Claude Code (check Anthropic's website for which plans include it): with the free account it doesn't work in the terminal. Download the program only from Anthropic's official website.
1. Open code.claude.com/docs (Anthropic's official documentation) and look for Install › Windows.
2. Copy the PowerShell command that page gives. Copy it only from there: never paste a command like that from an email, a video, a message or someone else's site, because it runs whatever is at the address it contains.
3. In R.I.V.E.R., press “+ New terminal” › PowerShell, paste the command (Ctrl+V), press Enter and wait for it to finish.
4. Close R.I.V.E.R. completely and open it again, so it finds the new AI.
5. Press “+ New terminal” › Claude. The browser opens: sign in to your Claude account and press “Authorize”. If the page shows you a code, copy it and paste it into the terminal.
6. The first time, Claude Code asks which colours you prefer and whether you trust the folder: press Enter on each one. If it says your plan doesn't include it, you need a paid Claude plan that includes Claude Code; it's purchased at claude.ai, from Anthropic.
The AIs, their plans and their screens belong to their companies and may change with their updates.

How do I install Codex (OpenAI) myself, without “Set up your AI”?

The easiest way is “Set up your AI”; this is in case that fails. Codex is OpenAI's agent for the terminal, an independent service from R.I.V.E.R., with its own account and terms. It's used with a ChatGPT account (check OpenAI's website for which plans include Codex). What's installed is Codex: the regular ChatGPT chat doesn't connect to R.I.V.E.R.
1. Open learn.chatgpt.com/docs (OpenAI's official documentation; Codex is downloaded from OpenAI's official websites) and look for the Codex CLI installation for Windows.
2. Copy the PowerShell command that page gives, only from that page: it runs whatever is at the address it contains.
3. In R.I.V.E.R., press “+ New terminal” › PowerShell, paste the command (Ctrl+V) and press Enter. If it asks “Start Codex now?”, type n and press Enter.
4. Close R.I.V.E.R. completely and open it again, so it finds the new AI.
5. In a PowerShell terminal, type codex login and press Enter. The browser opens: sign in to your ChatGPT account and accept.
6. Press “+ New terminal” › Codex (OpenAI).
The AIs, their plans and their screens belong to their companies and may change with their updates.

How do I install GitHub Copilot CLI myself, without “Set up your AI”?

The easiest way is “Set up your AI”; this is in case that fails. GitHub Copilot CLI belongs to GitHub, an independent service from R.I.V.E.R., with its own account and terms. It needs a GitHub account with access to GitHub Copilot (check GitHub's website for which plans include it). If your GitHub Copilot comes from a company, the company must allow GitHub Copilot CLI.
1. Open github.com/github/copilot-cli/releases and, in the latest version (Latest), download copilot-win32-x64.zip (or copilot-win32-arm64.zip if your PC is ARM, like some Snapdragon laptops).
2. Unzip it into %LOCALAPPDATA%\Programs\copilot-cli (paste that address into the File Explorer address bar; if the copilot-cli folder doesn't exist, create it). copilot.exe must end up inside it.
3. Add that folder to your user PATH: open Settings, search for “environment variables”, choose “Edit environment variables for your account”, select Path, press Edit and then New, paste %LOCALAPPDATA%\Programs\copilot-cli and press OK in both windows.
4. GitHub requires PowerShell 7. The simplest way is the Microsoft Store: open it, search for PowerShell (by Microsoft Corporation) and install it (that way it updates itself). You can also use Microsoft's official zip or MSI, explained at learn.microsoft.com (“Install PowerShell 7 on Windows”); the MSI needs administrator rights.
5. Close R.I.V.E.R. completely and open it again, so it finds the new AI.
6. In a PowerShell terminal, type copilot login and press Enter. It gives you a one-time code (copied to the clipboard by itself) and opens github.com/login/device in the browser: sign in to your GitHub account, paste the code with Ctrl+V and authorize GitHub Copilot CLI.
7. Press “+ New terminal” › GitHub Copilot CLI. The first time it asks whether you trust the files in the folder: choose whichever option suits you. If it says you don't have access, check at github.com that your account has access to GitHub Copilot; if it's a company account, ask whoever manages it.
The AIs, their plans and their screens belong to their companies and may change with their updates.

How do I install Google Antigravity CLI myself, without “Set up your AI”?

The easiest way is “Set up your AI”; this is in case that fails. Antigravity is a Google program and its use is governed by Google's terms (antigravity.google/terms). R.I.V.E.R. downloads it from Google, checks that it's genuine and opens it in a terminal: from then on you use it directly, with your personal Google account. It needs a personal Google account; Google Workspace plans don't include Antigravity (Google has separate options for businesses); check Google's website for its plans and terms.
1. Open antigravity.google (Google's official website) and look for the CLI installation for Windows.
2. Copy the PowerShell command that page gives, only from that page: it runs whatever is at the address it contains, so check it's from antigravity.google.
3. In R.I.V.E.R., press “+ New terminal” › PowerShell, paste the command (Ctrl+V) and press Enter.
4. Close R.I.V.E.R. completely and open it again, so it finds the new AI.
5. Press “+ New terminal” › Google Antigravity CLI. The browser opens: sign in with your personal Google account.
The AIs, their plans and their screens belong to their companies and may change with their updates.

If I uninstall R.I.V.E.R., are the AIs removed?

No: they stay on your PC. They belong to their companies and are uninstalled separately, as each one says on its website. If you want to remove the ones R.I.V.E.R. installed, delete their folder and remove its line from the PATH (in Windows, search for “Edit environment variables for your account” › “Path”):
• Claude Code: .local\bin\claude.exe and .local\share\claude inside your user folder.
• Codex: .codex\packages in your user folder and %LOCALAPPDATA%\Programs\OpenAI\Codex.
• GitHub Copilot CLI: %LOCALAPPDATA%\Programs\copilot-cli; PowerShell 7 (if R.I.V.E.R. installed it): %LOCALAPPDATA%\Programs\PowerShell7. The PowerShell 7 R.I.V.E.R. installs doesn't update itself; the Microsoft Store one does.
• Google Antigravity CLI: %LOCALAPPDATA%\agy.
Their accounts and subscriptions are cancelled on each company's website.

Voice says “no microphone found” or can't hear me

Voice control is part of the Pro Edition (and the trial). Plug in the microphone, set it as default in Windows Settings › Sound and check it isn't muted. Then turn voice off and on in Settings › Voice. The first time, internet is needed to download the voice model.

Voice doesn't understand me or wakes up on its own

Move closer to the microphone (less than a metre away), say “Hey River” clearly and train your “Hey River” in Settings › Voice. “Hey River, help” shows the exact commands. When you're not using it, mute it with Ctrl+Shift+M. How accurate it is depends on your voice, your microphone, your room and your processor.

F8 or F9 do nothing

They only work with voice on (Settings › Voice). With voice off they reach the terminal as usual. You can change the keys in Settings › Voice › Push to talk.

In a Claude terminal, pressing ← changes the screen

It's Claude's agent view, which opens when you press ← with the input box empty. The conversation hasn't closed: it keeps going in the background. Press Esc to go back.

How does it update?

It checks for updates when it opens and every 6 hours; if there's one, a button appears at the bottom. It shows you what changes and only installs if you say yes. If you installed it from the Microsoft Store, updates come through the Store, depending on how you have it set up.

What data does R.I.V.E.R. send?

What you write down (priorities, agenda, your own commands, themes) is stored on your PC and never sent anywhere, and voice is processed on your PC. R.I.V.E.R. only connects for the license, updates, your connection's ping and one-time downloads, and, if you ask, your AI's program from its company's website (“Set up your AI”). What you type into programs opened in the terminals (for example, your AI) is sent by them to their own services. More in the privacy policy.

Refunds, withdrawal and guarantee

It's all in the terms (sections 4 to 6). Those terms don't limit your rights as a consumer. To request it, write to us at hola@riverhud.com, use the form below or do it from your Paddle receipt; it's enough to tell us within the deadline. A person will reply.

Report a problem

If something in R.I.V.E.R. isn't working as it should, tell us here. We read every report and use it to fix problems in future versions.

Before sending, check the screenshot doesn't show passwords, keys or personal data.

Data protection. Controller: David Lacasa Herrera. Purpose: handle your report or question, find and fix the problem and, if you leave your email, send you a receipt with your report number and reply to you. Basis: the contract, if you're a customer; otherwise, our legitimate interest in handling your report and fixing problems in the program; if it's a complaint, also the legal obligation to give you a receipt and a reply. Retention: screenshots, 90 days after the report is closed; the rest, 2 years. Processors: Cloudflare, Vercel, Neon and, for the email receipt, Postmark (USA, under the Data Privacy Framework or standard clauses). Rights: access, rectification, erasure, objection, restriction and portability at hola@riverhud.com; you can complain to the Spanish DPA (AEPD). More in the privacy policy.