Install & update ReadyLynx
Windows
- Sign in at readylynx.com/account and download the Windows installer.
- Run it. ReadyLynx installs for your Windows user, starts after you sign in to Windows, and opens the ReadyLynx window.
- Continue with pairing the computer.
Mac and Linux
Mac and Linux versions are coming soon.
Updating
Windows: in the ReadyLynx window, click Check for Updates, then Install Update. ReadyLynx restarts by itself in about a minute and keeps your pairing, settings and workspace; your computer does not restart.
Automatic updates. ReadyLynx can install updates by itself when nobody has used the computer for about 10 minutes and no assistant work or background job is running. Turn this on or off in the ReadyLynx window under Settings > Updates. Computers check for updates every so often, so one computer may offer an update a little before another. Installing can take a few minutes; the window may show the old version until it restarts.
ReadyLynx only installs updates that carry our digital signature. If a download was changed in any way, it is refused and nothing is installed.
If ReadyLynx says an update needs the full installer, your copy is several versions behind. Download the installer from your account page and run it; it installs over the old version and keeps your settings.
Pair a computer & connect an AI assistant
- Turn on two-step verification first. In your account, verify your email (and optionally add an authenticator app). Pairing and connecting assistants need it, so a stolen password alone can never reach your computers.
- Pair the computer. In the ReadyLynx window, choose Connect this computer. It shows a code. Enter it at Account > Pair a computer, check that the computer name shown is yours, and approve.
- Connect your assistant. Add ReadyLynx as a connector (Claude) or app (ChatGPT) using
https://readylynx.com/mcp.php, sign in when asked, and approve the permissions it requests. - Ask your assistant to "list my ReadyLynx computers" to check everything is connected.
Skipped connecting an assistant during setup, or adding another one? Click Connect an AI assistant in the ReadyLynx window (bottom left), or under Settings > Access. Step-by-step instructions for each app are on Connect your assistant. The ReadyLynx window also shows which ReadyLynx account the computer is signed in to, so you can check your assistant uses the same account.
See every connected assistant at Account > Connected assistants, and disconnect any of them there. Connections end on their own after 90 days, and all of them end when you change your password; connect again to continue. Remove a computer at Account > My computers.
Approvals: why ReadyLynx asks before some actions
Some actions are on your always-ask list, for example sending email, running commands or controlling the mouse and keyboard. When an assistant tries one, it gets a link and the action waits for you. On the approval page you see exactly what will happen (the full command, recipients, attachments or each browser step) and confirm with a fresh two-step code.
When you approve, you choose how far the approval goes:
- Just this action, once: the assistant retries the same action within 10 minutes.
- Allow it for this assistant on this computer until the approval ends (for example until it has been idle for a set time).
- Always allow: removes that kind of action from your always-ask list.
Getting asked for every click? Desktop control (clicking and typing) is on the always-ask list by default. If you trust the assistant for a task, approve it for the session, or remove those actions from your list under Account > Remote control > always-ask settings. Your AI app may also ask before each tool use; that setting is in the AI app's connector settings.
Multi-step plans (Safe Preview) are approved on the computer itself, in the ReadyLynx window. The plan is fingerprinted, so nothing different from what you reviewed can run, and files a plan uploads are locked at the moment you approve.
Command access & protected folders (Windows)
Running PowerShell, starting programs and opening scripts is controlled by Command access in the ReadyLynx window. Only someone at the computer can turn it on or off. New installs start with it off. When it is off, assistants can still work with files, documents, email and the other tools.
Some folders are always off-limits to ReadyLynx file tools: ReadyLynx's own settings and updates, the Windows Startup folders, Office start-up and template folders, and PowerShell profiles. These are places where a changed file could run code automatically.
If you also allow desktop control, an assistant that controls the mouse and keyboard can start programs the same way you could. Approvals are your consent, not a sandbox: only approve what you understand.
Allowed folders
ReadyLynx file tools only work inside the folders you allow. On Windows, click Folder permissions in the ReadyLynx window to add or remove folders; new installs allow only the ReadyLynx workspace. Keep the list as small as your tasks need.
SSH & SFTP profiles
Assistants can run commands on your own servers and move files to and from them through saved profiles. Add a profile in the ReadyLynx window under SSH/SFTP Connections. Passwords and keys stay encrypted on your computer and are never sent to ReadyLynx or to the assistant. Each profile is limited to one folder on the server.
Server identity (host keys). ReadyLynx checks that it is talking to the right server every time. Either choose a known_hosts file you have already checked, or leave that box empty: ReadyLynx then saves the server’s key the first time it connects and shows its fingerprint (click Test connection to do this and compare the fingerprint with your server). After that, a server whose key has changed is refused. If you rebuilt the server or changed its key on purpose, edit the profile, clear the known_hosts box and save to learn the new key.
If a server stops accepting connections, check its firewall and SSH allowlist. Many hosts only allow listed IP addresses, and home internet addresses can change.
Browser automation
ReadyLynx can drive a separate, isolated browser so assistants can read pages, fill forms and click through websites without touching your own browser windows. Password and two-step fields stay private: assistants cannot read or type into them, and when a site needs you to sign in, ReadyLynx asks you to do it yourself. In the ReadyLynx window, Browser approvals sets which browser actions ask first (for example submitting forms).
Desktop control & screenshots
With desktop control switched on in the ReadyLynx window, assistants can take screenshots, click, type, press shortcuts and work with windows. They can also read and use buttons, fields and menus by name (UI Automation), which is faster and more reliable than clicking by position, so ask for that when an app supports it.
- Scaled screens. On laptops and 4K screens set to 125–300% scaling, ReadyLynx 0.24.98 and later click exactly where the screenshot shows. If clicks land in the wrong place, update ReadyLynx.
- Typing goes to the right window. An assistant can name the window it types into; if that window isn’t in front, nothing is typed rather than typing into the wrong app.
- Apps running as administrator can’t be clicked or typed into by ReadyLynx (Windows blocks it). Run the app normally, or use an admin command, which you approve on the computer.
- Hyper-V virtual machines. Assistants can see and control Hyper-V VMs on the computer. Keep the VM’s connection window open (it can be minimized) and use a basic session rather than an enhanced session: when an enhanced session disconnects, the VM screen looks locked to ReadyLynx even though it isn’t.
- Screenshots that don’t come back. If Windows doesn’t return a screenshot (for example from a VM that is starting up or a window that is busy), ReadyLynx gives up after about a minute and says so, instead of leaving the assistant waiting. Try again once the window has settled.
Email & calendar
On Windows, ReadyLynx works with classic Outlook (every account you have added to it) and with IMAP accounts you add in the ReadyLynx window under Settings > Connections > Mail accounts. Assistants can search and read mail, save attachments, draft, mark, move and send. Sending, and calendar invitations, ask you first.
- Use classic Outlook, not the new Outlook app. The new Outlook for Windows doesn’t let other programs work with it. In the new Outlook, turn off the New Outlook switch (top right) to go back to classic.
- Microsoft 365 work or school mail: add the account to classic Outlook. These accounts usually don’t allow IMAP sign-in with a password.
- Gmail, iCloud, Yahoo and others over IMAP need an app password from that provider (your normal password won’t work when two-step sign-in is on).
- Calendar uses classic Outlook. Assistants can read events and create them; invitations to other people ask you first.
Long tasks & background jobs
Commands that take a while (a build, a large download, a big file search) run as background jobs on the computer. The assistant gets a job number straight away and checks on it; the job keeps running even if the chat moves on or the assistant’s app times out. Checking on a job is free and doesn’t count as an action.
- See running jobs in the ReadyLynx window under Settings > Troubleshooting, where you can also cancel one. Or ask the assistant to cancel it.
- Only one desktop task (clicking, typing, screenshots) runs at a time on each computer, so two assistants don’t fight over the mouse. Jobs that don’t use the desktop, such as commands and SSH, can run alongside.
- Automatic updates wait until background jobs have finished (ReadyLynx 0.24.99 and later). If you click Install Update yourself while jobs are running, ReadyLynx warns you first, because installing restarts ReadyLynx and stops them.
Actions, limits & resets
An action is one thing an assistant does on a computer: reading a file, running a command, a click, a screenshot. Checking on something (listing computers, checking a job, reading a job’s output) is free.
- Your actions reset monthly on your own date: the day your plan renews, or on Free, the day you signed up. Yearly plans reset monthly too. Upgrading starts a fresh period straight away. See your usage and reset date at Account > Billing.
- Your plan’s actions don’t carry over to the next period.
- Extra actions you buy never expire. They are used only after your plan’s actions run out, and carry over until you use them. On Free, add 1,000 for $2.50; on a paid plan, add 25,000 for $5.
- We email you when you’ve used 80% of your plan’s actions, and again if you run out. When you run out, anything already running finishes; new actions wait until your reset date, or until you add actions or upgrade.
Keeping your account safe
- Use a unique password and keep two-step verification on.
- We email you when your password changes or an authenticator app is added. If it wasn't you, change your password right away; that also disconnects every AI assistant.
- Review Connected assistants and My computers now and then, and remove what you no longer use.
- Never paste passwords, API keys or device tokens into chats or support tickets.
Troubleshooting
My computer shows as offline
Make sure the computer is on, awake and online, and that ReadyLynx is running (open it from the Start menu). It reconnects by itself within a minute.
The assistant says the computer is busy or a process is blocking it
Only one desktop task runs at a time on each computer. A long job (for example a build, a large download or another assistant's work) holds the computer until it finishes. Wait for it, or use another computer.
An update says it needs the full installer
See Updating: download the installer from your account and run it.
I keep getting approval requests
See Approvals for how to approve for a whole session or change your always-ask list.
My assistant isn’t using ReadyLynx
Check, in this order: the assistant is connected (Account > Connected assistants); it is signed in to the same ReadyLynx account the ReadyLynx window shows; the assistant is allowed on that computer (ReadyLynx window, Settings > Access > Allowed assistants); and the ReadyLynx connector or app is turned on in the chat you are using. In ChatGPT you may need to turn ReadyLynx on for the conversation. To start over, click Connect an AI assistant in the ReadyLynx window. A test computer only answers the assistant connected to its account.
“Unknown computer”
The assistant used a computer’s name where ReadyLynx needs its ID. The message lists your computers and their IDs, and most assistants retry by themselves. If not, ask it to “list my ReadyLynx computers” first.
Clicks land in the wrong place
Update ReadyLynx: since 0.24.98 clicks match the screenshot on scaled screens (125–300%). If it still happens, the window may have moved between the screenshot and the click; ask the assistant to take a fresh screenshot, or to use the app’s buttons and fields by name instead. See Desktop control.
A virtual machine looks locked, or its screenshots time out
Open the VM’s connection window and switch it to a basic session (not enhanced), then leave the window open or minimized. See Desktop control.
An update seems stuck, or another computer got it first
Installing takes a few minutes, and ReadyLynx waits for running work to finish first. Computers check for updates every so often, so they don’t all see a new version at the same moment; click Check for Updates to look now.
A long job stopped partway through
Before 0.24.99, an automatic update could restart ReadyLynx while a background job was running. Update ReadyLynx and run the job again; updates now wait for jobs to finish.
“The host key ... has changed” (SSH)
The server is presenting a different identity from the one saved for it, so ReadyLynx refused to connect. If you rebuilt the server or changed its key, update the profile’s host key (see SSH & SFTP profiles). If you didn’t, don’t connect until you know why.
Reading a web page returns nothing
The page may still be loading, or the part the assistant asked for isn’t on it. ReadyLynx waits a few seconds for it, then says it found no match so the assistant can look at the page again or try a different part of it.
“Used all actions”
See Actions, limits & resets. Add actions or upgrade at Account > Billing; they are available within a minute of paying.
Still stuck?
Submit a ticket with your ReadyLynx version, your Windows version, what you were doing and the exact error text.