NexusAndroid

NexusAndroid

A real phone. Driven by your agents.

Android computer use for AI agents, over plain ADB: Claude Code, Codex and Antigravity see and drive your real Android phone. No root, no app on the phone, no cloud relay: a USB cable or the local Wi-Fi.

🌐 Website · 📦 Get it with NexusSystem · ▶️ Watch the video · 📝 Changelog

▶ Click to watch the video · more on julienpiron.fr

✨ Why NexusAndroid

📱 Your real phone, plain ADB No root, no app to install on the phone, no cloud relay: USB or local Wi-Fi. 👀 Sees, then acts A numbered UI tree, text first, and batched gestures, each one checked on a fresh reading of the screen. 💬 Messages without the screen SMS and RCS read from Android's own providers, replies prepared and sent only after your "yes".

⚡ Fast reads Conversation list in 0.07 s (35 s before 0.5.0), a full screen look in under 0.2 s over Wi-Fi. 🛡️ Safeguards built in Outward actions bound to your accord, codes masked, banking apps protected, one agent at a time. 🤝 One server, three agents Claude, Codex and Antigravity share one lock, one screen-awake session and the same safeguards.

Built and tested on a Samsung Galaxy Fold (SM-F971B, One UI) with a Windows PC. Other Android phones with USB debugging should work but have not been tested (see Compatibility). Everything sent to the client is in English: server instructions, tool descriptions and tool reports (results, refusals, errors).

See it in action

🚀 Quick start

Windows 10 or 11 (x64 or Arm64), an Android phone and a USB data cable, about 10 minutes, nothing to know beforehand. Since 0.22.0 the server is a single native Windows executable (C#, .NET 10, self-contained): no Python, no uv, no .NET to install. New versions are no longer published to PyPI; earlier packages stay available.

[!TIP]

Let your AI install it. Paste this sentence into Claude Code, Codex or Antigravity:

`text

Install and set up NexusAndroid for me by following https://raw.githubusercontent.com/pironjulien/NexusSystem/main/INSTALL-AI.md

`

Or the NexusSystem app from the Microsoft Store (winget install --id 9NSH2P3QLWT1 --source msstore), the main way to install it.

Setup walks you through connecting the phone and waits until it answers:

• on the phone, Settings > About phone (Samsung: > Software information) > tap Build number 7 times;
• Settings > Developer options > turn on USB debugging (Android guide);
• plug the phone in with a USB data cable and accept Allow USB debugging? (tick *Always allow*).

It ends with Ready. once the phone is connected and every AI app is configured; otherwise it says which part is not. Phone plugged in but never seen: install the maker's USB driver (Samsung). Then restart your AI app and ask it: *"Look at my phone and tell me what is on the screen."*

Manual install (verified)

In PowerShell, download the installer and the release's checksums as files, check the installer, then run it as a file (never piped into PowerShell from memory):

$r = 'https://github.com/pironjulien/NexusAndroid/releases/latest/download'

Invoke-WebRequest "$r/get.ps1" -OutFile get.ps1 Invoke-WebRequest "$r/SHA256SUMS.txt" -OutFile SHA256SUMS.txt Select-String ' get.ps1$' SHA256SUMS.txt # expected SHA-256 (Get-FileHash get.ps1 -Algorithm SHA256).Hash # must be the same (case aside) gh attestation verify get.ps1 --repo pironjulien/NexusAndroid # optional: build provenance powershell -NoProfile -ExecutionPolicy Bypass -File .\get.ps1

It downloads the latest release for this PC's architecture (NexusAndroid-win-x64.zip or NexusAndroid-win-arm64.zip), checks its SHA-256 against the release's SHA256SUMS.txt before extracting anything, installs it into ~\.nexus\nexus-android\releases\ , then runs NexusAndroid.exe setup. Setup finds adb or downloads Google's official Platform Tools, declares the server to the AI apps it finds (Claude Code, Claude Desktop, Codex, Antigravity; your own entries are kept, each edited file is backed up first), then walks you through connecting the phone (steps above). Run get.ps1 again (downloaded and checked the same way) to update.

Verify a download. Every release file (both zips, both .mcpb extensions, get.ps1, SHA256SUMS.txt) carries a Sigstore build provenance attestation: gh attestation verify NexusAndroid-win-x64.zip --repo pironjulien/NexusAndroid (the bundle is also attached as NexusAndroid- .intoto.jsonl).

Declare the server by hand (Claude Desktop, Claude Code, Codex, Antigravity, Cursor, VS Code)

Point the AI app at the installed executable with the argument --mcp (stdio):

• Claude Desktop: download nexus-android.mcpb (x64) or nexus-android-arm64.mcpb (Arm64) and open it (Settings > Extensions);
• Claude Code: claude mcp add nexus-android --scope user -- " \NexusAndroid.exe" --mcp (or, for the whole Nexus pack: /plugin marketplace add pironjulien/nexus-plugins, then /plugin install nexus-android@nexus-plugins);
• Codex: codex mcp add nexus-android -- " \NexusAndroid.exe" --mcp;
• Antigravity: agent panel ⋯ > MCP Servers > Manage MCP Servers > View raw config, add the nexus-android entry below inside "mcpServers", save.

Codex ~/.codex/config.toml:

[mcp_servers.nexus-android]

command = 'C:\Users\ \.nexus\nexus-android\releases\ \NexusAndroid.exe' args = ["--mcp"]

JSON clients (Antigravity, Claude Desktop, Cursor, VS Code):

{

"mcpServers": { "nexus-android": { "command": "C:\\Users\\ \\.nexus\\nexus-android\\releases\\ \\NexusAndroid.exe", "args": ["--mcp"] } } }

Setup reference: options, shared token, adb and scrcpy

NexusAndroid.exe setup options: --no-wait (declare and get adb, without waiting for the phone), --no-register (leave the AI apps alone), --apps claude-code,codex (only these AI apps: claude-code, claude-desktop, codex, antigravity; the pack passes its -Only/-Skip choice as NEXUS_PACK_TARGETS, same names). get.ps1 -NoWait passes --no-wait. Exit code: 0 everything ready, 1 adb or the phone not ready, 2 an AI app not configured, 3 both. The Nexus pack runs it with NEXUS_PACK=1: no question, no wait, exit code 0 on success and a last line NEXUS_PACK_RESULT Claude Desktop=declared; Codex=declared; Antigravity=plugin. In Antigravity the server comes as a plugin (~/.gemini/config/plugins/nexus-android: server and agent guide), never as a global entry. An entry written by an earlier version (uvx nexus-android) is replaced by the executable.

The HTTP daemon shares one token file with NexusRelay and NexusBrowser: NEXUS_MCP_TOKEN_FILE when set, otherwise %USERPROFILE%\.nexus\mcp-token.txt. The installer reuses that file (creates it once if absent), sets the user variable NEXUS_MCP_TOKEN to its content and never rotates an existing token. Restart AI apps after the first installation so they read the variable; installing another Nexus product keeps the same token.

adb is looked for in this order: NEXUS_ANDROID_ADB (full path), the PATH, the Android SDK (Android Studio's default folder), winget's Platform Tools, then ~/.nexus/nexus-android/tools/platform-tools- . When none is found, setup (or the server, in the background at start) downloads the current stable Platform Tools for Windows from Google's SDK repository (dl.google.com, the manifest sdkmanager reads), checks the size and SHA-1 Google publishes for the archive and unpacks it there; by using it you accept the Android SDK terms. NEXUS_ANDROID_ADB_DOWNLOAD=0 turns this off.

Typing accents and emoji needs the scrcpy server (Genymobile, Apache 2.0, version 5.0.1 pinned): setup (or the server at start) downloads it from the official scrcpy release on GitHub, checks its SHA-256 against the value written in the code and keeps it in ~/.nexus/nexus-android/tools. If the download is impossible (offline, proxy), accented text is refused with a message; it is never replaced by other text. ASCII typing works without it.

Example prompts

• *"Open Google Maps and start navigation to the nearest pharmacy."*
• *"Read my last SMS from Alice and draft a reply saying I'll be 10 minutes late."* (drafted, never sent without your "yes")
• *"Turn on do not disturb and lower the brightness."*
• *"Pull the last three photos from the phone to my PC."*
• *"Run a checkup: battery, storage, security patch, apps installed outside the stores."*

⚙️ How it works

flowchart LR

A["Claude Code"] --> S B["Codex"] --> S C["Antigravity"] --> S S["nexus-android MCP server (C#, .NET 10)"] -->|"ADB over USB or local Wi-