ShizuStore

Aether

Zhou-Shilin

2.1.7 · GitHub

Download APK
AI agents Android 8.0+ 1 month ago GPL-3.0
683 ShizuStore
11k GitHub
783 Stars
40 MB Size

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 Logo

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

Download on the App Store   Get the APK on GitHub


🌪️ 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 /sys are 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!

ko-fi

Afdian

Special Thanks

Star History


📄 License

This project is licensed under the GPL-3.0 License.


Built with ❤️ by Shilin "BaimoQilin" Zhou.

Close

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.createVirtualDisplay
  • DisplayManager.getDisplays
  • DisplayManager.getDisplay
  • VirtualDisplay.setSurface
  • VirtualDisplay.release
  • PendingIntent.getActivity
  • ActivityOptions.makeBasic
  • Context.createDisplayContext
  • PackageManager.queryIntentActivities
  • PackageManager.getLaunchIntentForPackage
  • ImageReader.newInstance
  • Display.getSize
  • Context.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.

Close

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

🧾 Included Commits

  • 476d0cb feat(pi): upgrade pi kernel to 0.85.1
  • 7e7498d fix(pi): update Node bundle loader patch
  • f275ca5 ci: check changed areas in pull requests
  • 0a932fd ci: build nightly APKs with bundled extensions
  • 091d855 fix(android): separate debug and nightly variants
  • 7d3eb3c feat: integrate iOS PostHog analytics, improve settings and markdown rendering, and fix unix socket path handling
  • 8c225d9 feat: add App Store link
  • 4dbd72d fix(ci): resolve PR checks and nightly inheritance
  • bd3c1bc fix(ci): skip removed Android SDK tools package
  • 4723e81 feat: add Alpine documents provider, offline showcase mode, and iOS keyboard dismissal
  • 54583f2 Merge pull request #77 from Chumor/ci/builds
  • b94a46c feat: upgrade pi kernel to 0.87.1 and add clipboard paste fallback for agent mode
  • b59e3b5 fix: deliver Termux RUN_COMMAND results via pending intent (#80)
  • 8bff84d fix(history): preserve unchanged messages during sync (#83)
  • d8e9ee3 fix(runtime): allow package installs in Alpine runtime
  • a30a157 fix(history): preserve Pi entry refs across branches (#86)
  • de24304 fix(history): preserve Pi context when editing messages
  • f69a2bb fix(agent-mode): make taps, focus and Unicode text input reliable
  • 8e99984 fix: align settings ui
  • 7dac1ba fix(settings): isolate extension settings state per category (#90)
  • b46388d fix(agent-mode): allow configuration without Termux (#98)
  • 22496bc fix(ios): decode OSC titles as UTF-8, fix scrollback desync, cap bridge heap (#97)
  • 8d7abc1 fix(agent-mode): act on the calling Android user on secondary users (#100)
  • 78c57fa feat(models): integrate models.dev capabilities and upgrade Pi dependencies
  • 722a6de fix(agent-mode): start the service without requiring Aether on the owner user (#100)
  • 20afc11 feat(statistics): show cache read and write tokens
  • e1193db feat(statistics): report whole-turn token totals and generation speed
  • cb6151b fix(statistics): keep turn totals across deferred follow-ups
  • ea0f6f8 Merge pull request #104 from yumiru11/main
  • 47860cf perf(ios): speed up launch by lazily restoring chat sessions and seeding demos
  • 474bb98 fix(chat): preserve retry branches and add native file previews
  • c80cb81 feat(phone-use): add accessibility phone use, Russian localization, and Pi session branching
  • b028e42 feat(phone-use): add accessibility phone use, Russian localization, and Pi session branching (@Leostrange)
  • 5327164 Merge remote-tracking branch 'origin/main'
  • 6542bfe chore: finalize 2.1.7

Full Changelog: https://github.com/Zhou-Shilin/Aether/compare/2.1.6...2.1.7

Close

Permissions

11 permissions requested

  • android.permission.INTERNET
  • android.permission.POST_NOTIFICATIONS
  • android.permission.FOREGROUND_SERVICE
  • android.permission.FOREGROUND_SERVICE_DATA_SYNC
  • android.permission.RECEIVE_BOOT_COMPLETED
  • android.permission.SCHEDULE_EXACT_ALARM
  • android.permission.REQUEST_INSTALL_PACKAGES
  • com.termux.permission.RUN_COMMAND
  • moe.shizuku.manager.permission.API_V23
  • android.permission.ACCESS_NETWORK_STATE
  • com.baimoqilin.aether.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION
Close