Repository navigation
Coding Agent 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.
- 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.
- 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.
- Scan the code with the phone's camera and open the link. It downloads the APK.
- 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.
- 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.
- Settings shows a QR code with the computer's Tailscale address, the port (7420) and a pairing code (the eye button shows the code).
- 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.
- 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.
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.
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. |
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.
- 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
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.
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.
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.
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
RulZ AI Trainer Optimizer
Using the app
Help
Rulz Training Captioner
Getting started
Using the app
Models and GPUs
Reference
RulZ LLM Suite
Using the app
- Getting Started
- Building the Engine
- Model Library
- Loading Models
- Chat
- MCP Tools
- Reverse Engineering
- Local API Server
Reference
Contributing
RulZ Coding Agent
Using the app
- Getting Started
- Projects and Tasks
- Approvals and Safety
- Model Settings
- Run and Share
- Notes and Instructions
- Extra Tools (MCP)
- Phone Access
- Android App
Reference
Contributing
RulZ Image Organizer
Using RulZ
- Getting Started
- Library and Scanning
- People and Corrections
- Search and Filters
- AI Tagging and Search
- Photo Viewer
- Appearance
More
RulZ Image Tournament
Using the app
- Getting Started
- How the Tournament Works
- Comparing Images
- Controls and Shortcuts
- Options and Settings
- Supported Formats
- Troubleshooting and FAQ
Developers
RulZ Image Crawler
Getting started
Using the app
Help
RulZ Image Preparer
Getting started
Using the app
Reference
RulZ Image Grid
Using the app
Help
RulZ Huggingface Manager
Using the app
Help
RulZ Simple Video Clip Extractor
Getting started
User guide
- Playback and Marks
- Fixed-Length Clips
- Exporting
- Clip List
- Scene Cuts
- Sound Waveform
- Crop, Rotate and Flip
- Colour Matching
- Distortion Repair
- Preferences and Themes
Help