Skip to main content
Android-Exclusive Feature: Termux integration and Shizuku system permission bridge are Android-specific technologies and supported only on Android devices.
Beyond the built-in Alpine VM, Aether can integrate with Termux for additional terminal capabilities and Shizuku for Agent Mode’s isolated virtual-display automation. Both integrations are optional — enable them only when you need what they provide.

​
Termux Integration

Termux is a powerful Android terminal emulator with its own package ecosystem. When you connect Aether to Termux, the agent can run commands directly in your Termux session and access its filesystem alongside (or instead of) the built-in Alpine environment.

​
Requirements

You must install Termux from F-Droid or the Termux GitHub releases page — not from the Google Play Store. The Play Store version does not support the RUN_COMMAND permission that Aether requires to execute commands in Termux.

​
Setup

  1. Install Termux from F-Droid or GitHub.
  2. Open Aether and go to Settings → Termux.
  3. Grant Aether permission to Run commands in Termux environment.
  4. Run Aether’s setup command in Termux to enable external apps, then return to Aether and refresh the status.

​
Use Cases

  • Access Termux’s broader package ecosystem (apt/pkg packages not available in Alpine).
  • Share your Termux home directory (~/) with the agent — handy if you already have tools, configs, or data there.
  • Run commands alongside other Termux sessions you have open.

​
Shizuku Integration

Shizuku grants Aether an elevated service without requiring a fully rooted device. With Shizuku active, Agent Mode can create and control an isolated Android virtual display.

​
Requirements

  • Shizuku installed from Google Play or GitHub.
  • Shizuku started via one of:
    • Wireless ADB debugging (no root required — available on Android 11+)
    • A rooted device using the Shizuku root method

​
Setup

  1. Install and start Shizuku following the Shizuku setup guide.
  2. Complete Settings → Termux, then open Settings → Agent Mode, choose Shizuku, and enable Agent Mode authorization.
  3. A Shizuku permission dialog appears — tap Allow.
  4. Save and refresh the authorization status, then enable Agent Mode for a chat from the composer.

​
What Privileged Agent Mode Enables

With Agent Mode authorized through Shizuku, the agent gains the following capabilities:

Virtual Displays

Create virtual Android displays independent of your physical screen.

App Launch

Launch an installed app on the isolated virtual display.

Touch Injection

Inject taps and swipes into the isolated virtual display.

Key Events

Send key events and type text into the focused app on the isolated virtual display.

Screenshots

Capture screenshots of the isolated virtual display for vision-based feedback loops.

App Inventory

List launchable installed apps and their package names for discovery and targeting.
Shizuku grants Aether significant elevated access. Agent Mode can launch apps, read screen content, and inject input on its isolated virtual display. Only enable this integration if you understand and trust the tasks you are asking the agent to perform.
Agent Mode can also use experimental Root authorization instead of Shizuku. Configure either method from Settings → Agent Mode after Termux setup is complete.