Your phone, automated.
A fork of RikkaHub that turns the native Android LLM chat client into a real on-device agent: 80+ device tools, AI-authored workflows, scheduled jobs, an in-app browser the AI drives, SSH, screen automation, file manager, music player, voice transcription, downloadable on-device LLMs, and a remote Telegram bot. All opt-in.
Website · Download · Features · Quick Start · Build
Tell it what to do in plain language. The phone runs it in the background while you live your life.
"Every weekday at 9am, summarize my unread WhatsApp into one Telegram message." "If my home server's disk fills up, ping me." "Watch my notifications. If anything from my boss comes in, forward it to Telegram." "Find the PDF on my phone that mentions 'invoice' and read me the first paragraph." "Take a screenshot every 30 minutes for the next 4 hours so I can see what I actually did all afternoon." "Use Termux to build me a webpage listing everything you can do, then open it in my browser." "When I plug in headphones at home WiFi after 7pm, start my evening playlist." "Open my router's admin page, sign in with the saved password, and tell me which devices are eating the most bandwidth right now." "Spin up two researches in parallel: one finds the cheapest one-way flight to Tokyo this month, the other lists hotels in Shibuya under $100."
Each of those is a one-line setup.
Tap, swipe, scroll, type, take screenshots, open apps, adjust brightness/volume, post notifications, check battery/WiFi/signal/location/sensors, read contacts & SMS, send SMS, set wallpaper, read/write NFC tags, sign and encrypt data with the Android Keystore, access external storage and SD cards, and manage ZIP archives. 80+ tools, all built into Android. Each one stays off until you flip it on.
Workflows — Describe a trigger and action in plain language: "when I get home, turn the ringer off." 19 triggers (WiFi, Bluetooth, headphones, geofence, app launch, notifications, time, charging, screen state, and more) and 14 conditions (battery thresholds, sunrise/sunset, day-of-week, foreground app, screen state) decide when each fires. Receivers register only when needed — battery drain stays minimal.
Schedules — Run tasks on any cadence: "every Monday at 8am", "every two hours", "next Friday at 3pm." Survives reboots and battery saver. Let the AI think at runtime, or pre-bake fixed actions that don't burn tokens.
Talk to your assistant from anywhere. Send a question, photo, PDF, or voice note. Approval prompts use simple Yes/No buttons. When the AI needs input, it pops a tappable multiple-choice question right in the chat. Long messages arrive as downloadable files. Message bursts are paced to avoid Telegram rate limits.
A real browser built into the app. The AI clicks through cookie banners, fills search boxes, scrolls, and reads pages back to you. Streams fresh screenshots to your chat after every step. Floating chat pill lets you keep talking to the AI without leaving the page. Built-in article extraction and diff-after-action keep token costs low.
Find files, read them, save new ones, copy, move, rename, delete. "Find every PDF mentioning 'invoice' on my phone" works in one sentence. System folders outside your app's sandbox are off-limits, even if you ask.
Save your servers once. Run commands, upload files, pull backups, check disk space, tail logs — all from chat. Pipe input into commands, write remote files, or launch long-running servers that return a PID instead of hanging. Works on WiFi or cell.
Play music through Android's normal media controls: lock-screen art, headphone keys, the works. Pause, resume, adjust volume — all from chat or Telegram. Your queue survives force-stops via snapshot fallback.
Drop a Markdown skill file and the AI gains a new playbook. A bundled catalog ships with a QR generator, Wikipedia query box, piano, interactive map, and more. Two skills enabled out of the box: an always-on agent playbook and an OpenClaw converter. Add skills from a URL or by sharing a Markdown file into the app.
For long tasks, the main assistant dispatches focused sub-agents into clean side-contexts, optionally on smaller, cheaper models. Run multiple in parallel. Each result comes back as a single summary. /stop cascades cancellation through every active child in one tick.
A built-in health checkup. Runs a full audit of permissions, background services, database integrity, network, Termux, and diagnostics. Tap auto-fix to grant permissions, restart services, or rebuild search indexes. Also available remotely via /doctor on Telegram.
Connect Model Context Protocol servers and the AI gains whatever tools they expose. The AI can add, update, and manage MCP connections itself — every change is approval-gated.
The AI can read, summarize, and forward incoming notifications from apps you choose. The whitelist starts empty. Other apps (Tasker, automation tools, ADB) can hand the agent tasks through the External Automation Intent API.
Three layers of protection:
- Per-assistant toggles — Every tool starts off. Flip on only what you want.
- Per-call approval — Tools that change something ask before running.
- HARDLINE floor — Genuinely dangerous commands (wipe, reboot, fork bombs, system file destruction) are blocked unconditionally.
Passwords and API keys never hit log files. Cloud backups skip saved credentials. The Telegram bot ignores everyone except your allowlist.
Download the latest *-release.apk from Releases. Allow install from unknown sources, then open.
Note: If you have an old debug build installed, uninstall it first — the release build is signed differently.
Upgrading from before
2.3.1-agent.0? The app ID changed toexcp.rikkahubso the fork installs alongside upstream RikkaHub. To migrate your data: open the old app → Settings → Backup → install this release → restore the backup.
Settings → Providers → pick one → paste your API key.
- OpenRouter — first-class support with auto-detected model capabilities, pricing, and routing
- Codex — sign in with your ChatGPT account (OpenAI plan over OAuth)
- Grok — sign in with your xAI account (SuperGrok or X Premium+ over OAuth)
- Local · LiteRT — download a local model (Gemma, Qwen). No key, no network. Runs on-device with GPU acceleration where supported
- AICore — Pixel 8/9/10 users can enable Gemini Nano for on-device inference (currently requires the AICore Beta)
Settings → Assistants → tap your assistant → Local Tools — flip the categories you want enabled.
If you don't turn anything on, the app behaves exactly like vanilla RikkaHub.
- Message @BotFather with
/newbotto get a token - Message @userinfobot with
/startto get your numeric user ID - Tell the assistant: "Set up the Telegram bot. Token is
<token>. My user id is<id>. Set me as the default chat. Enable it."
| Architecture | arm64 or x86_64 |
| Android | 8.0+ (API 26), targets API 37 |
| Storage | ~80 MB |
| LLM Provider | OpenAI, Google, Anthropic, OpenRouter, Codex, Grok, Ollama, or any OpenAI-compatible endpoint. OR Gemini Nano via AICore on Pixel 8/9/10+ |
The interface ships in English, 简体中文, 繁體中文, 日本語, 한국어, Русский, and العربية. The app follows your system language and falls back to English. RTL languages (Arabic, Persian, Urdu) render correctly in chat — code blocks stay LTR.
Requires bun and pnpm on your PATH — bun installs the web-ui dependencies, pnpm builds the bundle.
git clone https://github.com/ExTV/rikkahub-agent.git
cd rikkahub-agent
./gradlew :app:installDebugStands on the shoulders of giants:
| Project | Role |
|---|---|
| RikkaHub | The upstream chat client this forks |
| cron-utils | Cron parser for the scheduler |
| whisper.cpp | On-device speech-to-text via Termux |
| Termux | Shell + package manager |
| JSch (mwiede fork) | Native SSH client |
| FlorisBoard | Base for the companion agent-keyboard |
This fork is unaffiliated with upstream RikkaHub maintainers. All credit for the underlying chat client, provider abstraction, and UI design goes to the upstream team.