Skip to main content

​
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

SubcommandDescription
listList tasks for the current project
createCreate 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. 
aether task list [flags]
FlagDescription
--statusFilter by status: running, awaiting_input, failed, aborted
--started-at-opStarted-at filter operator: before, after, or equal
--started-at-dateStarted-at filter date (YYYY-MM-DD)
--ended-at-opEnded-at filter operator: before, after, or equal
--ended-at-dateEnded-at filter date (YYYY-MM-DD)
--orderTask order (created_at or agent_sidebar)
--limitMaximum tasks to return
--pagePage number
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

aether task list --status running

​
aether task create

Create a new task with a prompt. 
aether task create [flags]
FlagDescription
--promptThe prompt for the agent (required)
--stdinRead the prompt from standard input
--agent-typeOverride the project default agent type
--modelOverride the project default model
--interaction-modeOverride the project default interaction mode
--reasoning-effortOverride reasoning effort, or pass none
--auto-fix-ciEnable or disable CI auto-fix (true or false)
--auto-fix-pr-commentsEnable or disable PR comment auto-fix (true or false)
--auto-rebaseEnable or disable auto-rebase (true or false)
--context-fileInclude a workspace file path in prompt context; repeatable
--attachAttach 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 <id>

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]
FlagDescription
--messageThe response message (required)
--stdinRead the response from standard input
--interaction-modeOverride the follow-up interaction mode
--reasoning-effortOverride follow-up reasoning effort, or pass none
--context-fileInclude a workspace file path in follow-up context; repeatable
--attachAttach 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]
FlagDescription
--agent-typeAgent type
--modelModel
--interaction-modeInteraction mode
--reasoning-effortReasoning effort, or none
--auto-fix-ciAuto-fix CI (true or false)
--auto-fix-pr-commentsAuto-fix PR comments (true or false)
--auto-rebaseAuto-rebase (true or false)

​
aether task abort

Cancel a running task. 
aether task abort <id>

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 <id>

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.