aether run

Send a prompt to the agent and stream the response

aether run

Create a task from a prompt and stream the agent’s response in real time. This is the quickest way to interact with the agent from your terminal.

Usage

aether run <prompt> [flags]

Flags

Flag	Description
--no-watch	Create the task without streaming output. Prints the task ID and exits immediately.

Global flags are also available. See CLI Overview.

Examples

Send a quick task

aether run "fix the login bug"

The agent starts working immediately. Output streams to your terminal as the agent reads files, runs commands, and writes code.

Create a task without streaming

aether run "add dark mode" --no-watch

Task created: task_a1b2c3d4

Use aether task watch to stream the output later:

aether task watch task_a1b2c3d4

Override the project

aether run "update the README" -p proj_xyz

Get JSON output

aether run "list all API routes" --json --no-watch

{
  "id": "task_a1b2c3d4",
  "status": "running",
  "project_id": "proj_xyz"
}