Skip to content

Coding Agent Android App

speedyrulz edited this page Nov 15, 2026 · 3 revisions

Android App

RulZ Coding Agent for Android is a remote control for RulZ Coding Agent on your computer. From the phone you can give tasks, answer the agent's questions, follow its steps and changed files, run your app and undo. The AI, RulZ LLM Suite and your projects all stay on the computer; the phone only shows what happens there and sends your choices back.

The phone reaches the computer over Tailscale, so it works from anywhere without opening anything to the internet. For the computer's side (turning phone access on, and how it is protected), see Phone Access.

What you need

  • An Android phone with Android 7.0 or later.
  • RulZ Coding Agent on the computer, with Let my phone connect turned on under Settings → Phone access. Some features need a newer version there; see Features and versions.
  • Tailscale on the computer and on the phone, signed in to the same account.

Install the app

  1. Open the RulZ AI Tools Suite launcher on the computer (1.11.0 or later). On the home page, press Coding Agent for Android to show its QR code (since 1.14.0; older versions show the code on the home page itself). The Phone app card on the RulZ Coding Agent page shows it too.
  2. Scan the code with the phone's camera and open the link. It downloads the APK.
  3. Open the APK to install it. Android asks you to allow installing apps from that source (your browser or files app) the first time.

The code always points at the newest release. Copy link copies the same download link, and Release notes opens the release. The APKs are also on the suite's Releases page as RulZ-Agent-<version>.apk, in releases tagged coding-agent-android-v<version> (versions before 0.5.0 are in the archived old repository).

The app doesn't update itself. To update, download and install the newest APK the same way. If the phone's app and the computer's app are too far apart to work together, the phone says which one needs updating.

Pair with the computer

  1. On the computer, open Settings → Phone access and turn on Let my phone connect. The first time, Windows may ask whether RulZ Coding Agent may use your networks. Allow it, or the phone can't connect.
  2. Settings shows a QR code with the computer's Tailscale address, the port (7420) and a pairing code (the eye button shows the code).
  3. Scan the QR code with the phone's camera and tap the link. The app opens, saves the computer and connects.

No camera, or scanning doesn't work? In the app tap Add computer, then No camera? Type it in instead. Paste the pairing link if you copied it, or type the Address, Port and Pairing code shown on the computer, give it a Name if you like, and tap Connect.

The app remembers the computers you paired. The start screen lists them under Your computers: tap one to connect, or the bin button to forget it.

Staying connected

  • The app reconnects by itself after the phone sleeps or switches networks, more slowly while it is in the background to save battery. While it is reconnecting, a banner says so, and Try again tries at once.
  • After a wrong pairing code it does not try again by itself, because every try counts: after 10 wrong codes the computer stops listening to that phone for 10 minutes. Check the code and tap Try again.
  • Make a new code on the computer disconnects every phone using the old one. Scan the new QR code to connect again.
  • The computer's address and pairing code are kept in the app's private storage and left out of Android backups.

If it can't connect at all, see Troubleshooting.

Projects

The project open on the computer is shown at the top of the project list. Below it you can make a New project (type a name and tap Create; Change picks another folder for it), open one of Your projects, or use Open folder to browse the computer's folders. The bin button only removes a project from the list; its folder is kept.

The computer has one open project at a time, so opening a project on the phone opens it on the computer too, and the computer's window follows.

Working on a project

The project's name is at the top, with the model in use underneath it. Tap the model to switch models. Four tabs sit below:

Tab What it shows
Chat What you asked and what the agent says, live. Type the next task and tap the arrow; the red square stops the task. When the agent asks a question, the box answers it. When it is stuck, choose Keep going, Try another way or Stop. The model's thinking shows in a Thinking… box that folds into Thought process when it answers; tap it to open or close it.
Steps Each step the agent took, with its command and output. When the agent keeps a checklist for the task, Plan at the top shows it with "N of M done": a tick for done, a spinner for the step it is on, a dot for one started but not finished, an empty circle for one not started (since 0.7.0). When the task used a draft model (MTP), Drafts at the top shows how many drafted tokens were accepted and about how much time that saved; tap it for the counts.
Files Every file the task created, changed or deleted, as a diff. Long diffs show the first 2,000 lines.
App Run my app on the computer and watch what it prints. Fix this hands an error to the agent. For a web app, Open on this phone opens it in the phone's browser through the computer's Tailscale address; the app's server must accept visits from other devices (for Vite, start it with --host). If the agent doesn't know how to start the app yet, Ask the AI to work it out or type the command yourself.

Is this OK?

When the agent wants your OK, an Is this OK? sheet comes up over whatever you're looking at, with what it wants to do, any risks, its reason and Show details. Choose Allow, Allow for this task or Don't allow, as on the computer (see Approvals and Safety). The back button or a swipe doesn't refuse by accident: the question stays open, here and on the computer, until someone answers it.

The ⋮ menu

  • Run my app (or Stop my app)
  • Share my app: package the project into one file on the computer (Run and Share)
  • Undo last task
  • Reverse engineering (also on a card on a new project's first screen): the same Start, Practice and Done tabs as on the computer. Type the target's path on the computer, or browse its folders. Record for training in RulZ LLM Suite is on by default.
  • History: every task, with Go back to before this
  • Notes: Things to always remember for this project
  • Settings

Notifications

Under Settings → Notifications:

  • When a task is finished, with the agent's last words.
  • When I'm waiting for you: a permission request, a question or a pause. It disappears once it's answered, on the phone or on the computer.

Tap a notification to go to the project. Notifications only come while the app isn't on screen.

To get them while the app is closed, turn on Stay connected in the background. Android then shows a small ongoing notification that says what the agent is doing (working, waiting for your OK, a question, paused), and while a task runs the phone stays awake so messages arrive right away. If notifications stop after the phone has been locked a while, use Battery settings to let the app run without battery limits. Settings also says when Android has turned notifications off for the app (Open notification settings), has Send a test notification, and shows the last notification sent.

Model and settings

Tap the model under the project name to pick another one (not while a task runs). Models marked Ready are already loaded and start right away; the sheet also has a shortcut to Model settings.

Settings has three parts:

  • On your computer: these change RulZ Coding Agent on the computer too. AI model, with Model settings underneath: How it writes and How it loads, the same as on the computer except Expert offload (MoE), which is only on the computer. Also Keep thinking open after the answer, When should I ask you first?, Instructions for every project, Extra tools, and under Show details the folder new projects go in, Most steps per task and Time limit for one command.
  • Notifications: see above.
  • This phone: the Look (Dark, Light or Same as phone), This phone's name (shown on the computer while it is connected), Switch computer and Forget this computer.

Only on the computer

The phone can't change phone access, the RulZ LLM Suite address or its API key (the phone never receives the API key, and the computer doesn't send the pairing code back after pairing), and it can't open dialogs, the browser or Explorer on the computer. A few things are also only in the computer's window:

  • adding a note while a task runs, and the Copy, Edit, Run again and Delete buttons on messages (Projects and Tasks),
  • Expert offload (MoE) in Model settings,
  • Record tasks for reverse-engineering training.

Features and versions

Most of the app works with RulZ Coding Agent 0.6.0 or later on the computer. These need newer versions:

Feature Needs on the computer
Model settings RulZ Coding Agent 0.8.0; GPU split, draft tuning and the memory estimate also need RulZ LLM Suite 0.3.7
Choosing the draft model RulZ Coding Agent 0.9.2 and RulZ LLM Suite 0.3.9
Thinking box and Drafts RulZ Coding Agent 0.10.0
Keep thinking open after the answer RulZ Coding Agent 0.11.0
Reverse engineering RulZ Coding Agent 0.18.0 and RulZ LLM Suite 0.15.0
The agent's Plan (phone app 0.7.0) RulZ Coding Agent 0.20.0

What changed in each version of the phone app is listed under What's new, in the rows marked Android.

RulZ AI Tools Suite

The apps

RulZ AI Trainer

README (full reference) Releases

RulZ AI Trainer Optimizer

Using the app

Help

README (full reference)

Rulz Training Captioner

Getting started

Using the app

Models and GPUs

Reference

README (full reference)

RulZ LLM Suite

Using the app

Reference

Contributing

README (full reference)

RulZ Coding Agent

Using the app

Reference

Contributing

README (full reference)

RulZ Image Organizer

Using RulZ

More

README (full reference)

RulZ Image Tournament

Using the app

Developers

README (full reference)

RulZ Image Crawler

Getting started

Using the app

Help

README (full reference)

RulZ Image Preparer

Getting started

Using the app

Reference

README (full reference)

RulZ Image Grid

Using the app

Help

README (full reference)

RulZ Huggingface Manager

Using the app

Help

README (full reference)

RulZ Simple Video Clip Extractor

Getting started

User guide

Help

README (full reference)

Clone this wiki locally