Mobile Access

Monitor and control your agent swarm from any phone or tablet — on your local network or anywhere in the world.

How it works

Clustr's dashboard is a Progressive Web App (PWA) that runs in any mobile browser. Pairing is done via a one-time QR code that embeds a secure session token — no account or sign-in required.

Pairing your phone (local network)

  1. Start Clustr as usual: npx clustr-ai
  2. Open the dashboard in your desktop browser and click the Connect Phone button (📱) in the header.
  3. A pairing modal appears with a QR code and a local network URL.
  4. Scan the QR code with your phone's camera. Your phone opens the dashboard automatically, already authenticated.

Your phone and computer must be on the same Wi-Fi network for local pairing to work.

Adding to your home screen

The dashboard ships with a PWA manifest, so you can install it as a home-screen app for a native-feel experience:

  • iOS (Safari): tap the Share button → “Add to Home Screen”
  • Android (Chrome): tap the browser menu → “Add to Home Screen” or “Install app”

Remote access over cellular

To reach Clustr from outside your local network — on a cellular connection or a different Wi-Fi — start Clustr with the tunnel flag:

CLUSTR_TUNNEL=1 npx clustr-ai

This starts a Cloudflare tunnel and prints a public HTTPS URL in the terminal. The pairing QR code will automatically include this URL so scanning it works from any network.

Prerequisite: cloudflared must be installed on your machine before using CLUSTR_TUNNEL=1.

Security

All API routes and Socket.io connections require a session token when accessed remotely. The token is generated fresh each time Clustr starts and is embedded in the QR code URL. The pairing endpoint itself (which serves the QR code) is only accessible from localhost, so only someone with local access to the machine can generate a new token.

Previous← CLI & Configuration