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

aether task <subcommand> [flags]

Subcommands

Subcommand	Description
list	List tasks for the current project
create	Create a new task
get <id>	Get task details
respond <id>	Send a follow-up message to a running task
abort <id>	Cancel a running task
watch <id>	Stream live output from a task

aether task list

List tasks in the current project.

aether task list [flags]

Flag	Description
--status	Filter by status: running, completed, failed, aborted

aether task list

ID              STATUS      PROMPT                          CREATED
task_a1b2c3d4   running     fix the login bug               2 min ago
task_e5f6g7h8   completed   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)

aether task create --prompt "add input validation to the signup form"

Task created: task_a1b2c3d4

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]

Flag	Description
--message	The response message (required)

aether task respond task_a1b2c3d4 --message "use bcrypt instead of argon2"

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.