Sign In & Bind Your Machine
One last step: tell the agent which server to use and set the password you'll type in the browser. This is called binding — after it, your computer shows up as a machine (device) on that server.
Start the sign-in
- macOS — click the menu bar icon → Sign in.
- Linux — run
code-setupin a terminal. - Windows — the agent prompts on first launch.
The sign-in opens a page in your browser (on a headless box, code-setup prints a link you can open from any device).
On the binding page
- Pick a server node. If the server offers several nodes, each shows a wifi-style latency signal — pick the closest one. Self-hosting a single server? There's just one entry.
- Set your web password. This is what you'll type to open the web UI from your phone or any browser.
- Machines bound with the same password belong to the same account and can all be seen and switched between in the web UI.
- Confirm — the agent connects, and the page drops you into the web UI.
On Linux, code-setup also enables the agent service at this point, so it survives reboots.
Open it from anywhere
From now on, on any device:
- Open
https://your-server-address/in a browser. - Enter your web password.
- You're looking at your computer. Open a project and go: Open a Project.
TIP
On your phone, do this once in Safari/Chrome and then add it to your home screen — it opens full-screen like a native app afterwards.
Where the binding is stored
The agent keeps its identity in ~/.code/ on your computer. Reinstalling or updating the agent keeps it — you won't need to sign in again. Deleting ~/.code resets the machine (it will bind as a brand-new device next time).