ReadyLynxSubmit a ticket

Help guides.

Step-by-step help for setting up and using ReadyLynx.

Install & update ReadyLynx

Windows

  1. Sign in at readylynx.com/account and download the Windows installer.
  2. Run it. ReadyLynx installs for your Windows user, starts after you sign in to Windows, and opens the ReadyLynx window.
  3. 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

  1. 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.
  2. 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.
  3. 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.
  4. 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:

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.

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.

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.

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.

Keeping your account safe

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.