Skip to content

ZubrCode from your phone

The ZuBrIQ app for Android and iPhone is a full ZubrCode client in your pocket: set tasks for the agent, watch the feed of edits, and confirm commands from your phone.

  • Write to the agent, watch the feed (file reads, diff edits, commands), and confirm shell commands;
  • open Code sessions from the zubriq.ai chat and sessions of your own zubrcode remote runner (your own runner);
  • connect to your own ZubrCode server over the local network, Tailscale, a VPN, or your own TLS proxy.

There are two ways to work with code:

  1. Code sessions through your ZuBrIQ account — no network setup. Recommended.
  2. Direct connection to your own ZubrCode server — local network, Tailscale, VPN, TLS proxy.

“ZubrCode Connect” — connecting from anywhere without tunnels — is in the works; the app already has a card labeled “Coming soon” where you can join the waitlist.

  • Android — Google Play: by.zubriq.code;
  • iPhone — beta via TestFlight, link on the Apps page.

Sign in with the same zubriq.ai account you use in the chat.

Section titled “Way 1: Code sessions through your account (recommended)”

No network setup at all: no IP addresses, ports, or tunnels — sessions reach the app through your ZuBrIQ account.

On the connections tab, pick the ZuBrIQ card and tap Sign in with ZuBrIQ — confirm the sign-in in the browser. Below the card you’ll see the Code sessions list. It includes:

  • sessions from the zubriq.ai chat, Code section (how chat sessions work);
  • sessions of your own zubrcode remote runner (your own runner) — the machine can be behind NAT, no inbound ports needed.

Tap a session to open it. You can stop the runner right from the app — unpushed changes are lost. If the runner is stopped, the session shows: “The runner is not ready or has been stopped. Open the session in the chat to start it again.” If the list is empty: “No sessions yet — start one in the ZuBrIQ chat, Code section.”

The app connects directly to a ZubrCode server on your computer — over the local network, Tailscale, a VPN, or your own TLS proxy.

ZubrCode version 2.x is required. Once, in the foreground (the password is set with the OPENCODE_SERVER_PASSWORD variable):

Окно терминала
OPENCODE_SERVER_PASSWORD='a-strong-password' zubrcode serve --hostname 0.0.0.0 --port 4096

--hostname 0.0.0.0 listens on all interfaces; without it the server is only reachable from the computer itself.

As a background service:

Окно терминала
zubrcode service set password 'a-strong-password'
zubrcode service set hostname 0.0.0.0
zubrcode service set port 4096
zubrcode service start
zubrcode service status

The service also has stop, restart, get, and unset.

Open the Connect to ZubrCode screen: enter the IP address, optionally a Name (optional) and the Password (if set on the server), then tap Connect.

The default username is opencode. A different name, a full address, and other options are in Advanced settings (tunnels, cloud, authentication):

  • Connection type — Local / Tunnel / Cloud;
  • Server address — full, with http:// or https://, for example http://192.168.1.100:4096;
  • Project directory (optional) — empty means the server’s current directory;
  • Username and Password;
  • Save connection.

Before saving, the app checks the connection. On failure you’ll see Could not connect with the address and the error text, plus a Share report button.

Hints right on the screen:

  • find your IP on a Mac: ipconfig getifaddr en0;
  • Tailscale addresses: http://100.64.12.34:4096 or http://my-mac.tailnet.ts.net:4096;
  • use http:// for local addresses and Tailscale; https:// only if TLS is configured;
  • the server starts with zubrcode serve --hostname 0.0.0.0.

In the connections list, a tap switches to a connection, and a long press opens Edit — with Test connection and Remove connection. The Messages per page setting loads fewer messages at a time — the page opens faster.

  • Never expose a ZubrCode server port to the internet without a password.
  • From outside your home network, connect only through Tailscale/a VPN or your own TLS proxy.
  • Want to work “from anywhere” without tunnels? Use way 1 with zubrcode remote.
  • Is the server running with --hostname 0.0.0.0 (otherwise it only listens locally)?
  • Is the phone on the same network or tailnet as the computer?
  • Is the port correct and the scheme right: http:// for local addresses and Tailscale, https:// only with TLS configured?
  • Is the password entered and the username opencode (unless the server uses another one)?
  • Is the computer’s firewall not blocking the port?
  • Still failing — tap “Share report” on the error screen and send the report.

The app updates through the app store. Removing it erases only the settings and connections on the phone — sessions and data on the server and in your ZuBrIQ account stay intact.