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.
What you can do from your phone
Section titled “What you can do 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 remoterunner (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:
- Code sessions through your ZuBrIQ account — no network setup. Recommended.
- 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.
Install the app
Section titled “Install the app”- 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.
Way 1: Code sessions through your account (recommended)
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 remoterunner (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.”
Way 2: your own ZubrCode server
Section titled “Way 2: your own ZubrCode server”The app connects directly to a ZubrCode server on your computer — over the local network, Tailscale, a VPN, or your own TLS proxy.
Start the server
Section titled “Start the server”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.0zubrcode service set port 4096zubrcode service startzubrcode service statusThe service also has stop, restart, get, and unset.
Connect in the app
Section titled “Connect in the app”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://orhttps://, for examplehttp://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:4096orhttp://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.
Security
Section titled “Security”- 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.
If it won’t connect
Section titled “If it won’t connect”- 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.
Updating and removal
Section titled “Updating and removal”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.