Aether
2.1.7 · GitHub
More about this app
Localized, extensible general-purpose AI agent for Android, iOS and macOS, with optional Shizuku and Termux integration for direct device control.
Aether
Soar with local AI.
A stunning, localized, highly extensible general-purpose AI Agent for Android, iOS and macOS.
中文 • Visuals & Experience • Extensions • Core Features • Documentation
![]() |
![]() |
![]() |
![]() |
🌪️ Aether
"When the great Peng bird journeys to the Southern Ocean, it flaps the water for three thousand miles, spiraling upward on a whirlwind (Aether/Fuyao) to ninety thousand miles, and travels for six months before resting."
Aether is dedicated to bringing a modern, local AI Agent experience to mobile and desktop devices (Android, iOS, and macOS). Built on top of the Pi framework, it pairs a minimalist, polished UI with immense extensibility, seamless tool calling, and full extension ecosystem support.
🧩 High Extensibility
Aether natively supports loading standard Pi Extensions. To bring TUI-oriented extensions seamlessly to mobile touchscreens, Aether provides a rich Extension API allowing extensions to inject custom settings cards, interactive composer widgets, overlay transcript viewers, prompt interceptors, and semantic tool titles.
| Extension | Description | Repository |
|---|---|---|
| Pi Web Access* | Web search across 20+ providers (OpenAI, Brave, Exa, Tavily, Perplexity, Gemini, SearXNG), GitHub repo cloning, PDF extraction, and YouTube/video understanding with native settings and transcript cards. | AetherExtensions/pi-web-access |
| Pi MCP Adapter* | Model Context Protocol (MCP) gateway supporting Stdio, Streamable HTTP, SSE, and Unix domain sockets with lazy loading, token-saving tool discovery, interactive OAuth authentication, and a visual server management GUI. | AetherExtensions/pi-mcp-adapter |
| Pi Subagents* | Claude Code-style autonomous sub-agents with parallel background execution, mid-run steering, live widget & FleetView cards above the composer, conversation overlay viewer, and @handle prompt mentions. |
AetherExtensions/pi-subagents |
* means it's an official extension adapted by the Aether team. Add your extension to the list by submitting a PR.
Extensions can be installed directly as zip packages in Settings → Extensions → Import extension.
For extension development documentation, see https://aether.baimoqilin.com/docs/extensions/overview.md.
📱 Visuals & Experience
Aether's UI and interactions are heavily inspired by excellent, mature applications like ChatGPT, Codex CLI/App, Gemini, and Poco Agent. Every animation and interaction detail has been carefully polished to break the stereotype that "open-source means cheap and unrefined."
![]() |
![]() |
![]() |
✨ Core Features
- Stunning UI & Silky Smooth Interactions: Distilling the design essence of top-tier apps like ChatGPT to create a minimalist, modern, and elegant interface.
- Pi Harness Kernel: Powered by the Pi framework, providing the widest LLM provider compatibility and a lightweight, highly efficient Agent execution engine.
- Extreme Extensibility: Inherits Pi's complete extension model while providing Aether's proprietary Script Extensions and Native Mods system to deeply customize mobile UI, settings, composer widgets, and runtime behavior.
- Built-in Alpine VM: Includes an automatically installed Alpine Linux environment to run shell commands and tools out of the box.
- System File Manager Access (Android): After initializing Alpine, select Aether (Alpine) in the system Files app or SAF document picker's sidebar to browse the environment and
/workspace, create, edit, rename, delete, or copy files between Alpine and device storage. Changes apply directly to the files used by proot. System mounts such as/dev,/proc, and/sysare excluded. - Extensible Host Control: Supports optional Shizuku and Termux integration for direct device manipulation and automation. (Android only)
🚀 Quick Start
See https://aether.baimoqilin.com/docs/quickstart.
🤝 Contributing
This project is being developed sporadically by a 15yo student during their spare time (ʘᴗʘ✿). Aether is still actively iterating and being polished. If you like this project, please consider giving it a ⭐ Star, or submit PRs and Issues to help make Aether even better!
Special Thanks
- OpenAI Codex
- Google Gemini
- Linux DO Community
Star History
📄 License
This project is licensed under the GPL-3.0 License.
Built with ❤️ by Shilin "BaimoQilin" Zhou.
How Shizuku is used
Can run an isolated virtual display, launch apps on it, list apps and displays, and stream its preview via Shizuku using `DisplayManager.createVirtualDisplay`.
This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.
How this app uses Shizuku
Shizuku powers an isolated Phone Use display where the AI agent can open and observe apps separately from the main screen.
- Run isolated display: the agent creates and manages its own virtual display for automation, with live preview, detach and stop support.
- Launch apps remotely: an app name or package chosen by the agent is opened directly on the agent display through Shizuku.
- List installed apps: the agent lists launchable apps with names, packages and system status to pick what to open, using the privileged package query through Shizuku.
- Inspect displays: the agent lists system displays with size and whether its virtual display is active through Shizuku.
- Stream live preview: the agent display picture is attached to and detached from the on screen preview through Shizuku.
Android APIs or commands used
DisplayManager.createVirtualDisplayDisplayManager.getDisplaysDisplayManager.getDisplayVirtualDisplay.setSurfaceVirtualDisplay.releasePendingIntent.getActivityActivityOptions.makeBasicContext.createDisplayContextPackageManager.queryIntentActivitiesPackageManager.getLaunchIntentForPackageImageReader.newInstanceDisplay.getSizeContext.createPackageContextAsUser
Notable details
Taps, swipes, typing, keys and screenshots are performed through the accessibility service, not through Shizuku. App and display lists fall back to the normal on device query when the privileged service is unavailable.
Changelog
What's new for version 2.1.7
🚀 Aether v2.1.7 Changelog
✨ New Features
- Phone Use on Android: Added foreground phone control through Accessibility, with element-tree and screenshot strategies, on-screen feedback, and Root/Shizuku Virtual Display options.
- Model Capabilities: Integrated models.dev capabilities, thinking levels, and context/output limits into provider selection and the Pi runtime on Android and iOS.
- Usage Statistics: Added cache read/write tokens, whole-turn token totals, and generation speed, including deferred follow-ups.
- Files & Demos: Added an Android Alpine documents provider, native file previews on both platforms, and offline showcase conversations.
- Localization: Added Russian translations across Android and iOS.
🛠 Improvements & Optimizations
- Streaming Replies: Added shared overlapping fades for text fragments, complete headings, and code blocks on Android and iOS, with reduced-motion support and continuity when replies finish.
- Pi Runtime: Updated bundled Pi dependencies to 0.99.2 and improved Node bundle loading.
- iOS Startup: Restored chat sessions lazily and optimized showcase seeding to reduce launch work.
- iOS Experience: Integrated PostHog analytics, improved settings and Markdown rendering, and added keyboard dismissal controls.
- Builds: Improved pull-request checks, bundled extensions into nightly APKs, and separated Android debug and nightly applications.
🐛 Bug Fixes
- Phone Use Responsiveness: Moved Accessibility observations off the main thread, prevented stale snapshots after cancellation, warmed overlay resources, and restored permission prompts after access is revoked.
- Conversation History: Preserved Pi entry references and context during synchronization, edits, and retry branching, while retaining unchanged messages.
- Android Phone Control: Improved taps, focus, Unicode input, clipboard fallback, secondary-user handling, service startup, and configuration without Termux.
- Runtime: Fixed Termux command-result delivery, Alpine package installation, and Unix socket paths.
- iOS Terminal: Corrected UTF-8 OSC titles and scrollback synchronization, and capped bridge heap usage.
- Settings: Isolated extension settings by category and aligned settings presentation.
🔀 Merged Pull Requests
- Build Automation: improve pull request checks and nightly Android builds by @Chumor in https://github.com/Zhou-Shilin/Aether/pull/77
- Termux Results: fix: deliver Termux RUN_COMMAND results via pending intent by @Chumor in https://github.com/Zhou-Shilin/Aether/pull/80
- History Synchronization: fix(history): preserve unchanged messages during sync by @Chumor in https://github.com/Zhou-Shilin/Aether/pull/83
- Pi Branch References: fix(history): preserve Pi entry refs across branches by @Chumor in https://github.com/Zhou-Shilin/Aether/pull/86
- iOS Reliability: iOS: bug fixes, crash prevention & performance improvements by @CN00K in https://github.com/Zhou-Shilin/Aether/pull/97
- Agent Mode Setup: fix(agent-mode): allow configuration without Termux by @yumiru11 in https://github.com/Zhou-Shilin/Aether/pull/98
- Usage Statistics: feat(statistics): show cache tokens and report whole-turn totals by @yumiru11 in https://github.com/Zhou-Shilin/Aether/pull/104
🧾 Included Commits
476d0cbfeat(pi): upgrade pi kernel to 0.85.17e7498dfix(pi): update Node bundle loader patchf275ca5ci: check changed areas in pull requests0a932fdci: build nightly APKs with bundled extensions091d855fix(android): separate debug and nightly variants7d3eb3cfeat: integrate iOS PostHog analytics, improve settings and markdown rendering, and fix unix socket path handling8c225d9feat: add App Store link4dbd72dfix(ci): resolve PR checks and nightly inheritancebd3c1bcfix(ci): skip removed Android SDK tools package4723e81feat: add Alpine documents provider, offline showcase mode, and iOS keyboard dismissal54583f2Merge pull request #77 from Chumor/ci/buildsb94a46cfeat: upgrade pi kernel to 0.87.1 and add clipboard paste fallback for agent modeb59e3b5fix: deliver Termux RUN_COMMAND results via pending intent (#80)8bff84dfix(history): preserve unchanged messages during sync (#83)d8e9ee3fix(runtime): allow package installs in Alpine runtimea30a157fix(history): preserve Pi entry refs across branches (#86)de24304fix(history): preserve Pi context when editing messagesf69a2bbfix(agent-mode): make taps, focus and Unicode text input reliable8e99984fix: align settings ui7dac1bafix(settings): isolate extension settings state per category (#90)b46388dfix(agent-mode): allow configuration without Termux (#98)22496bcfix(ios): decode OSC titles as UTF-8, fix scrollback desync, cap bridge heap (#97)8d7abc1fix(agent-mode): act on the calling Android user on secondary users (#100)78c57fafeat(models): integrate models.dev capabilities and upgrade Pi dependencies722a6defix(agent-mode): start the service without requiring Aether on the owner user (#100)20afc11feat(statistics): show cache read and write tokense1193dbfeat(statistics): report whole-turn token totals and generation speedcb6151bfix(statistics): keep turn totals across deferred follow-upsea0f6f8Merge pull request #104 from yumiru11/main47860cfperf(ios): speed up launch by lazily restoring chat sessions and seeding demos474bb98fix(chat): preserve retry branches and add native file previewsc80cb81feat(phone-use): add accessibility phone use, Russian localization, and Pi session branchingb028e42feat(phone-use): add accessibility phone use, Russian localization, and Pi session branching (@Leostrange)5327164Merge remote-tracking branch 'origin/main'6542bfechore: finalize 2.1.7
Full Changelog: https://github.com/Zhou-Shilin/Aether/compare/2.1.6...2.1.7
Permissions
11 permissions requested






