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]

Flag	Description
`--no-watch`	Create the task without streaming output. Prints the task ID and exits immediately.
`--stdin`	Read the prompt from standard input
`--agent-type`	Override the project default agent type
`--model`	Override the project default model
`--interaction-mode`	Override the project default interaction mode
`--reasoning-effort`	Override reasoning effort, or pass `none`
`--auto-fix-ci`	Enable or disable CI auto-fix (`true` or `false`)
`--auto-fix-pr-comments`	Enable or disable PR comment auto-fix (`true` or `false`)
`--auto-rebase`	Enable or disable auto-rebase (`true` or `false`)
`--context-file`	Include a workspace file path in prompt context; repeatable
`--attach`	Attach a local image file; repeatable

Global flags are also available. See CLI Overview.

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.

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

aether run "update the README" -p proj_xyz

cat prompt.txt | aether run --stdin --context-file src/auth/login.ts --attach screenshot.png

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

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