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
Manage agent tasks. Tasks represent individual agent runs that read files, execute commands, and write code in a workspace.
Usage
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.
| 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 |
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
aether task list --status running
aether task create
Create a new task with a prompt.
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 |
aether task create --prompt "add input validation to the signup form"
Task created: task_a1b2c3d4
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.
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.
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 |
aether task respond task_a1b2c3d4 --message "use bcrypt instead of argon2"
aether task update
Update task settings used by future turns and automations.
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.
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.
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.
Ctrl+C to detach from the stream without aborting the task.
