> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```bash theme={null}
aether run <prompt> [flags]
```

## 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](/cli/overview).

## Examples

### Send a quick task

```bash theme={null}
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

```bash theme={null}
aether run "add dark mode" --no-watch
```

```
Task created: task_a1b2c3d4
```

Use `aether task watch` to stream the output later:

```bash theme={null}
aether task watch task_a1b2c3d4
```

### Override the project

```bash theme={null}
aether run "update the README" -p proj_xyz
```

### Read from stdin with context

```bash theme={null}
cat prompt.txt | aether run --stdin --context-file src/auth/login.ts --attach screenshot.png
```

### Get JSON output

```bash theme={null}
aether run "list all API routes" --json --no-watch
```

```json theme={null}
{
  "id": "task_a1b2c3d4",
  "status": "running",
  "project_id": "proj_xyz"
}
```