Connect your own computer
Install Cue CLI and connect a computer to your Cue.
You can connect a Mac, Linux computer or Windows computer using WSL2 to a Cue you already chat with. Cue CLI is the app that connects the computer to Cue OS.
Before you start
- Have a Cue OS account and an agent. See Getting started.
- Use macOS or Linux, or follow Setup on Windows.
- Install Node.js 22.13.0 or later from nodejs.org. In a terminal, run
node --versionto check it.
Connect an agent to your own computer
-
On the web, open your Cue's Agent info → Computer. Choose Your computer, then Show setup steps.
-
If your Cue has a cloud computer, save its files before changing computers. Files are not automatically copied to your computer. Your account, conversations and server-saved data stay. If pairing does not complete while the cloud computer is attached, see Your agent's computer for the delete option and its consequences.
-
On the computer you want to connect, open a terminal and install Cue CLI:
curl -fsSL https://cueos.ai/install.sh | bash -
Open a new terminal and sign in with the Cue OS account that created the agent:
cue login -
Copy the pairing command shown in Show setup steps and run it on that computer. It has this form:
cue agent create <agent-name> --pair <one-time-code>Use the name and code shown for your Cue. The code works once and expires after ten minutes. Open the setup steps again for a new one if needed.
-
Wait for the computer to connect. Keep it awake and Cue CLI running while the Cue needs it. You can choose Cue, Codex or Claude Code when the engine is available on the computer.
To switch back, open Agent info → Computer and choose Cloud computer. See Your agent's computer for reset and file-loss details.
With Cue CLI
cue --version
cue agent list
cue agent status <agent-name> --jsonIf cue is not found, open a new terminal and follow the installer's instructions. cue doctor can help find a connection problem; review its output before sharing it because it can contain account details.