Skip to main content

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

FlagDescription
--no-watchCreate 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"
}