{k}

Kay Remote

Support

We’re happy to help you get connected.

What Kay Remote is

Kay Remote is a mobile client for the Kimi Code command-line tool. It connects to the kimi web server running on your own computer — over your local network or Tailscale — so you can watch, steer, and control a session from your phone or iPad. It is a client, not a standalone agent: it needs your own computer running the server.

Before you start, you’ll need

• Kimi Code CLI version 0.27 or later on your computer
• The server running: kimi web --host
• Your phone or iPad able to reach that computer, over Tailscale or the same network

Reaching your computer: Tailscale (recommended) or a VPN

Kay Remote connects straight to your own computer, so your phone has to be able to reach it:

• Same Wi-Fi — if your phone and computer are on the same home or office network, a plain local (LAN) connection works with no extra setup.
• Anywhere else — on mobile data, at a café, or on a different network — you need a private network that links the two devices. Tailscale is the best option, and the one we recommend.

Why Tailscale: it’s a free, quick-to-install mesh VPN. Put it on both your computer and your phone, sign in with the same account, and they get stable private addresses that reach each other from anywhere — no port forwarding, no firewall changes, and nothing exposed to the public internet. The npm run pair command automatically prefers your Tailscale address when it builds the QR code, so pairing “just works” off your home network.

1. Install Tailscale on your computer and your phone from tailscale.com/download, signed in to the same account on both.
2. Start the server: kimi web --host, then run npm run pair.
3. Scan the QR code in Kay Remote — you’re connected, on any network.

Any other VPN that places your phone and computer on the same private network will also work, but Tailscale is by far the simplest to set up.

Connect in one scan

On the computer running the server:

kimi web --host        # start the server (token still required)
npm run pair           # in the app project folder — prints a QR code

Then open Kay Remote, tap Scan QR code (or use the iOS Camera app), and the server URL and token fill in automatically. No account to create, nothing to type.

Prefer to type it in? Enter the server URL (e.g. http://100.x.y.z:58627) and the token from ~/.kimi-code/server.token on that computer.

Common questions

The app can’t reach my server.

Make sure kimi web --host is running, and that your phone and computer are on the same network or the same Tailscale tailnet. The npm run pair command checks reachability and tells you what to fix.

Is my data private?

Yes. Kay Remote has no servers and collects nothing — everything flows directly between the app and your own machine. See the Privacy Policy.

How do I reset the connection or token?

Disconnect in the app to clear the saved URL and token on your device. To rotate the server token, run kimi web rotate-token on your computer.

Something else?

Email 92combo@gmail.com with what you’re seeing and which device you’re on, and we’ll help.