> ## 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 task

> Create, monitor, and manage agent tasks

# aether task

Manage agent tasks. Tasks represent individual agent runs that read files, execute commands, and write code in a workspace.

## Usage

```bash theme={null}
aether task <subcommand> [flags]
```

## Subcommands

| Subcommand                         | Description                                |
| ---------------------------------- | ------------------------------------------ |
| `list`                             | List tasks for the current project         |
| `create`                           | Create a new task                          |
| `get <id>`                         | Get task details                           |
| `status <id>`                      | Show compact task status                   |
| `update <id>`                      | Update task turn defaults                  |
| `respond <id>`                     | Send a follow-up message to a running task |
| `abort <id>`                       | Cancel a running task                      |
| `steer <id>`                       | Send steering feedback                     |
| `archive <id>`                     | Archive a task                             |
| `unarchive <id>`                   | Unarchive a task                           |
| `clear-queue <id>`                 | Clear queued task items                    |
| `remove-from-queue <id> <item-id>` | Remove one queued item                     |
| `watch <id>`                       | Stream live output from a task             |

## aether task list

List tasks in the current project.

```bash theme={null}
aether task list [flags]
```

| Flag                | Description                                                        |
| ------------------- | ------------------------------------------------------------------ |
| `--status`          | Filter by status: `running`, `awaiting_input`, `failed`, `aborted` |
| `--started-at-op`   | Started-at filter operator: `before`, `after`, or `equal`          |
| `--started-at-date` | Started-at filter date (`YYYY-MM-DD`)                              |
| `--ended-at-op`     | Ended-at filter operator: `before`, `after`, or `equal`            |
| `--ended-at-date`   | Ended-at filter date (`YYYY-MM-DD`)                                |
| `--order`           | Task order (`created_at` or `agent_sidebar`)                       |
| `--limit`           | Maximum tasks to return                                            |
| `--page`            | Page number                                                        |

```bash theme={null}
aether task list
```

```
ID              STATUS      PROMPT                          CREATED
task_a1b2c3d4   running     fix the login bug               2 min ago
task_e5f6g7h8   awaiting_input add dark mode                 1 hour ago
task_i9j0k1l2   failed      deploy to production            3 hours ago
```

```bash theme={null}
aether task list --status running
```

## aether task create

Create a new task with a prompt.

```bash theme={null}
aether task create [flags]
```

| Flag                     | Description                                                 |
| ------------------------ | ----------------------------------------------------------- |
| `--prompt`               | The prompt for the agent (required)                         |
| `--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                       |

```bash theme={null}
aether task create --prompt "add input validation to the signup form"
```

```
Task created: task_a1b2c3d4
```

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

## aether task get

Get details and status of a specific task.

```bash theme={null}
aether task get <id>
```

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

```
ID:       task_a1b2c3d4
Status:   running
Prompt:   fix the login bug
Created:  2025-01-15T10:30:00Z
Duration: 2m 15s
```

## aether task respond

Send a follow-up message to a task that is waiting for input or still running.

```bash theme={null}
aether task respond <id> [flags]
```

| Flag                 | Description                                                    |
| -------------------- | -------------------------------------------------------------- |
| `--message`          | The response message (required)                                |
| `--stdin`            | Read the response from standard input                          |
| `--interaction-mode` | Override the follow-up interaction mode                        |
| `--reasoning-effort` | Override follow-up reasoning effort, or pass `none`            |
| `--context-file`     | Include a workspace file path in follow-up context; repeatable |
| `--attach`           | Attach a local image file; repeatable                          |

```bash theme={null}
aether task respond task_a1b2c3d4 --message "use bcrypt instead of argon2"
```

## aether task update

Update task settings used by future turns and automations.

```bash theme={null}
aether task update <id> [flags]
```

| Flag                     | Description                              |
| ------------------------ | ---------------------------------------- |
| `--agent-type`           | Agent type                               |
| `--model`                | Model                                    |
| `--interaction-mode`     | Interaction mode                         |
| `--reasoning-effort`     | Reasoning effort, or `none`              |
| `--auto-fix-ci`          | Auto-fix CI (`true` or `false`)          |
| `--auto-fix-pr-comments` | Auto-fix PR comments (`true` or `false`) |
| `--auto-rebase`          | Auto-rebase (`true` or `false`)          |

## aether task abort

Cancel a running task.

```bash theme={null}
aether task abort <id>
```

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

```
Task aborted: task_a1b2c3d4
```

## aether task watch

Stream live output from a running task. Attaches to the task's output stream and displays events as they happen.

```bash theme={null}
aether task watch <id>
```

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

```
[agent] Reading src/auth/login.ts...
[agent] Found the issue — missing null check on line 42
[agent] Writing fix to src/auth/login.ts...
[agent] Running tests...
[agent] All tests pass. Task complete.
```

Press `Ctrl+C` to detach from the stream without aborting the task.