Nexus

Connect your phone's system voice assistant to your own model, and give it the ability to call tools, execute tasks, and operate your device.

Nexus is an extensible voice Agent for Android.

It can take over some of the system voice assistant entry points, hand your voice requests to a custom model, and complete real tasks through capabilities such as Skills, MCP, Shell, and SSH.

You can choose your own model service, and configure tools and behavior rules. For requests that should not be handled by the Agent, Nexus can also hand them back to the original system assistant.

Core Capabilities

Extensible Agent System

Nexus is not just about swapping the language model behind your voice assistant. It provides an extensible Agent runtime that lets the model call tools, access external services, and execute multi-step tasks based on your requests.

• Skills: Extend the Agent's task-handling ability through reusable skill descriptions
• MCP: Connect to external tools and data sources such as GitHub, Notion, and HomeKit
• Takeover Rules: Define which requests are handled by Nexus and which are handed back to the system assistant
• Memory System: Persist user preferences and long-term context across sessions
• Conversation History: View, continue, or fork past Agent conversations

Android System Capabilities

Nexus can execute terminal tasks at different privilege levels depending on the device environment and user authorization:

1. Normal app permissions: Perform basic operations that require no extra authorization
2. Shizuku: Gain more complete Android system operation capabilities
3. Root: Execute advanced system tasks on rooted devices

Different privilege levels correspond to different available capabilities. Nexus does not require the device to be rooted; users can choose according to their own device conditions.

Shell & SSH

Nexus can connect to local or remote terminal environments:

• Connect to Termux to use Linux commands and tools on your Android device
• Connect to a dev machine or server via SSH to execute remote tasks
• Let the Agent generate commands, execute them, and analyze results based on natural-language requests

As a result, you don't need to write every terminal command by hand — just describe the goal, and the Agent plans and completes the corresponding operations.

Headless AI Coding

Through SSH, Nexus can connect to Claude Code running on a dev machine or server.

You can issue development tasks directly by voice from your phone, and Nexus will connect to the remote environment, invoke the Coding Agent, and bring the results back to the current conversation.

Model Support

Nexus supports configuring a variety of model services, including:

• OpenAI
• Anthropic
• Google
• DeepSeek
• Compatible endpoints

Nexus does not provide built-in model accounts. Before use, you need to prepare an API Key for the corresponding model service and configure it in the app.

Technical Components

Nexus is built on the following projects:

• AI Conversations & Tooling: s3ss10n
• User Interface: Material 3 Expressive × AndroidLiquidGlass
• Shell & SSH: libterm

Download & Usage

Please head to Releases to download the latest version.

Before first use, please prepare:

• A compatible Android device
• At least one API Key for a supported model service
• Configure Shizuku, Root, Termux, or SSH as needed (optional)

For specific configuration methods and current version support, please refer to the in-app instructions.

Build from Source

The source of this repository is open — you can also compile it yourself.

Requirements: JDK 17 and the Android SDK (or Android Studio directly).

Debug Build

The Debug build uses an auto-generated debug signature, no extra setup needed:

./gradlew assembleDebug

Output is at app/build/outputs/apk/debug/app-debug.apk.

Release Build

Official releases are signed with the author's private key, which is not included in this repository. To build a Release version yourself, use your own signing key:

# 1. Generate a keystore
keytool -genkeypair -v -keystore my-release.jks \
  -keyalg RSA -keysize 2048 -validity 10000 -alias my_key

# 2. Pass signing info via -P (or write it into gradle.properties to replace the placeholders)
./gradlew assembleRelease \
  -PRELEASE_STORE_FILE=/abs/path/my-release.jks \
  -PRELEASE_STORE_PASSWORD=yourStorePassword \
  -PRELEASE_KEY_ALIAS=my_key \
  -PRELEASE_KEY_PASSWORD=yourKeyPassword

Output is at app/build/outputs/apk/release/app-release.apk.

Community & Feedback

Join the Telegram community to chat, ask questions, or report issues.

If you run into problems, please try to provide the following information:

• Phone model and Android system version
• The system voice assistant currently in use
• The system voice assistant version
• Nexus version
• Steps to reproduce
• Screenshots or screen recordings
• Relevant logs (if available)

Complete information can significantly improve the efficiency of diagnosing issues.

Notes

Nexus is still in a phase of rapid iteration, and some features may change. Operations involving Shell, Shizuku, or Root carry higher system privileges — please use them with an understanding of the relevant commands and risks.