Skip to main content
Android-Exclusive Feature: Agent Mode (virtual display device automation) is currently supported only on Android devices.
Agent Mode gives Aether an isolated Android virtual display that it can control with the agent_display tool. Shell commands, file tools, Skills, MCP servers, and the multi-step Pi agent loop are available without Agent Mode.

​
How to Enable Agent Mode

Complete Termux setup, then authorize Agent Mode in Settings → Agent Mode with Shizuku or experimental Root access. Toggle the Agent Mode button in the composer menu to make the virtual-display tool available in that chat.

​
What Aether Can Do

Shell Commands

Run any shell command inside the built-in Alpine Linux VM — from simple utilities to long-running scripts. This does not require Agent Mode.

File Management

Read and write files within the Alpine filesystem, create directories, and pipe output between tools. This does not require Agent Mode.

Code Execution

Execute Python, Node.js, shell scripts, and any other runtime you’ve installed in Alpine via apk add. This does not require Agent Mode.

Skills & MCP

Use Skills and call MCP servers for web search, custom APIs, and more. This does not require Agent Mode.

Android Automation

With Agent Mode enabled, inject taps, swipes, key events, and text, capture screenshots, and control apps on an isolated virtual display.

​
The Agentic Loop

The Pi framework drives a tool-use loop at the core of every Aether conversation:
  1. You send a task description.
  2. The LLM decides which tool to call and with what arguments.
  3. Aether executes the tool (shell command, file read/write, Skill call, etc.).
  4. The result is fed back into the next LLM turn as context.
  5. Steps 2–4 repeat until the LLM determines the task is complete and returns a final answer.
This loop continues automatically — you don’t need to prompt again between steps. The agent can run dozens of tool calls for a single complex task.

​
Pausing and Steering

You don’t have to let the agent run uninterrupted. At any point during generation you can:
  • Pause: Tap the stop button in the composer to halt the current generation immediately.
  • Steer: Use the Steer input that appears mid-generation to send a follow-up instruction. The agent incorporates your message into the ongoing context without restarting the task from scratch.
Aether’s tools are powerful. The agent can read and modify files in configured runtimes, and Agent Mode can control apps on an isolated Android virtual display. Always review the plan for long or complex tasks — especially if the task involves sensitive files, network requests, or irreversible operations — before letting it run to completion.
Start with simple, well-scoped tasks (e.g., “open Settings on the isolated display and take a screenshot”) to get a feel for how Agent Mode behaves before you hand it multi-step workflows.