Dices Alpha Get Dices

Use Dices from Your Phone

Install Dices as a phone app over Tailscale and mirror your desktop's chats, context, and settings securely.

Dices runs a small local server on your machine that serves an installable mobile app, letting you reach your desktop cockpit from your phone. The phone becomes a thin client to your PC’s backend, so you get the same chats, context, and settings wherever you are.

How it works

Dices serves an installable PWA (Progressive Web App). When you open its URL on your phone and tap Add to Home Screen, it installs like a native app — fullscreen, with the Dices icon, no browser chrome.

This is not a separate, standalone copy of Dices. The phone app mirrors your machine: the agents and your code live on your PC, and the phone is a full mirror of that backend. As a consequence, your PC must be on and running Dices for the phone app to work. Close the laptop lid or shut the machine down and the mirror goes dark.

Note: Because the phone is a thin client, anything you do on it — start a chat, run an agent, change a setting — happens on your PC and shows up identically on the desktop, and vice versa. There is nothing to sync.

Security model

This is the most important part to understand before you expose anything.

By default, the Dices server binds only to:

  • Your Tailscale interface (a WireGuard-encrypted mesh network), and
  • Loopback (127.0.0.1, the local machine itself).

It does not bind to your open Wi-Fi or LAN by default. That means the phone app is not reachable over a coffee-shop network, an untrusted office LAN, or the public internet — only over the encrypted Tailscale mesh.

On top of the network binding, every request is token-gated. Each install gets a stable per-install token, so a device that hasn’t been authorized cannot talk to the backend even if it can reach the address.

Warning: The point of binding to Tailscale + loopback only is that your agents have full access to your machine and code. Do not weaken this unless you understand the exposure. Treat the per-install token like a password.

Optional LAN access

There is an opt-in “Allow LAN access” toggle in Settings. It is off by default. Turn it on only if you specifically want to reach Dices from another device on the same trusted Wi-Fi without Tailscale. Requests are still token-gated, but you lose the WireGuard encryption and the “only my mesh” guarantee, so leave it off unless you need it.

Set it up step by step

The recommended path uses Tailscale so you can reach your PC from anywhere, not just your home Wi-Fi.

  1. Install Tailscale on your PC and sign in.
  2. Install Tailscale on your phone and sign in to the same Tailscale account, so both devices join the same mesh.
  3. On your PC, open Settings → Phone app. The secure Tailscale URL appears there automatically.
  4. On your phone, open that Tailscale URL in the browser.
  5. Tap Add to Home Screen. Dices installs as a fullscreen app with its own icon.

That’s it. Open the app from your home screen any time your PC is on, and you’re looking at a live mirror of your desktop cockpit.

Tip: The Tailscale URL in Settings → Phone app works from anywhere your phone has a connection — cellular, hotel Wi-Fi, anywhere — because Tailscale builds an encrypted tunnel back to your PC. You don’t need to be on the same network.

Same-Wi-Fi without Tailscale

If you don’t want to use Tailscale and both devices are on a network you trust:

  1. Enable Settings → Allow LAN access.
  2. Use the LAN URL shown in Settings → Phone app on your phone.
  3. Add to Home Screen as above.

Remember this path is unencrypted at the network layer and only works while both devices share that Wi-Fi.