au3 task — Command Reference

CLI command group: au3 task

Commands for viewing, canceling, and waiting on tasks, task logs, artifacts, locks, traces, and reports.

---

Sections

Section	Commands
Artifact (sub-group)	5
Lock (sub-group)	2
Trace (sub-group)	3
Report (sub-group)	2
Task (top-level)	6

---

au3 task list

List tasks

Option	Type	Required	Default	Notes
--limit				Number of items to return in the requested page. The server limit may be less than the requested limit.
--since	string		2026-08-31T19:33:21.333Z	Datetime to start search from
--before	string			Task id to start listing from. Omit for latest in set.
--after	string			Task id to start listing after. If before is not present, last task will be the next id after the specified id.
--fields	string			Comma-separate list of fields to display
--filter	string			Filter in JSON/YAML format or path to file containing filter
--search	string			Seach in JSON/YAML format or path to file containing search
--all	boolean		false	Whether to fetch results from all pages
--stream	boolean		false	Whether to print results as they are received without buffering (as JSON)
--fmt	enum		human	Output format Choices: "human", "json", "yaml"
--debug	boolean		false	Enable more verbose output on error

---

au3 task view

View task

Option	Type	Required	Default	Notes
--id	string	✅		task id
--fields	string			comma-separate list of fields to display
--fmt	enum		human	Output format Choices: "human", "json", "yaml"
--debug	boolean		false	Enable more verbose output on error

---

au3 task cancel

Cancel task

Option	Type	Required	Default	Notes
--id	string	✅		task id
--fmt	enum		human	Output format Choices: "human", "json", "yaml"
--debug	boolean		false	Enable more verbose output on error

---

au3 task wait

Wait for task to finish

Option	Type	Required	Default	Notes
--id	string	✅		comma-separate list of tasks to watch
--fmt	enum		human	Output format Choices: "human", "json", "yaml"
--debug	boolean		false	Enable more verbose output on error

---

au3 task log

List log messages

Option	Type	Required	Default	Notes
--id	string	✅		task id
--before	string			Datetime which all results are before
--after	string			Datetime which all results are after
--direction	enum		OLDEST_FIRST	Choices: "OLDEST_FIRST", "NEWEST_FIRST"
--filter	string			Filter to narrow the returned results in filter JSON format
--fmt	enum		human	Output format Choices: "human", "json", "yaml"
--debug	boolean		false	Enable more verbose output on error

---

au3 task artifact

au3 task artifact list

List artifacts

Option	Type	Required	Default	Notes
--id	string	✅		task id
--fmt	enum		human	Output format Choices: "human", "json", "yaml"
--debug	boolean		false	Enable more verbose output on error

---

au3 task artifact view

View artifact

Option	Type	Required	Default	Notes
--id	string	✅		task id
--artifact	string	✅		artifact id
--fmt	enum		human	Output format Choices: "human", "json", "yaml"
--debug	boolean		false	Enable more verbose output on error

---

au3 task artifact download

Download task artifact

Option	Type	Required	Default	Notes
--id	string	✅		task id
--artifact	string	✅		artifact id
--fmt	enum		human	Output format Choices: "human", "json", "yaml"
--debug	boolean		false	Enable more verbose output on error

---

au3 task artifact upload

Upload task artifact

Option	Type	Required	Default	Notes
--id	string	✅		task id
--artifact	string	✅		artifact id
--path	string			Path to file to upload
--fmt	enum		human	Output format Choices: "human", "json", "yaml"
--debug	boolean		false	Enable more verbose output on error

---

au3 task lock

au3 task lock list

List task locks

Option	Type	Required	Default	Notes
--fields	string			Comma-separate list of fields to display
--filter	string			Filter in JSON/YAML format or path to file containing filter
--sort	string			Ordered list of fields to sort by in JSON/YAML format or path to file containing sorting
--search	string			Search in JSON/YAML format or path to file containing search
--limit			100	Number of results to fetch
--skip				Number of results to skip
--all	boolean		false	Whether to fetch results from all pages
--stream	boolean		false	Whether to print results as they are received without buffering (as JSON)
--fmt	enum		human	Output format Choices: "human", "json", "yaml"
--debug	boolean		false	Enable more verbose output on error

---

au3 task trace

au3 task trace view

View task trace

Option	Type	Required	Default	Notes
--id	string	✅		task id
--fmt	enum		human	Output format Choices: "human", "json", "yaml"
--debug	boolean		false	Enable more verbose output on error

---

au3 task trace visualize

Visualize trace

Option	Type	Required	Default	Notes
--task	string	✅		task id
--format	enum		graphviz	Output format Choices: "graphviz", "full", "mermaid-gantt", "graphviz-entities"
--filter	string			Filter in JSON/YAML format or path to file containing filter
--fmt	enum		human	Output format Choices: "human", "json", "yaml"
--debug	boolean		false	Enable more verbose output on error

---

au3 task report

au3 task report state-timeline

State Timeline

Option	Type	Required	Default	Notes
--since	string		2026-08-31T19:33:54.093Z	Datetime to start search from
--filter	string			Filter in JSON/YAML format or path to file containing filter
--format	enum	✅		report format Choices: "full", "tsv"
--resolution	enum	✅		bucket resolution Choices: "1sec", "5sec", "10sec", "30sec", "1min", "5min", "10min"
--fmt	enum		human	Output format Choices: "human", "json", "yaml"
--debug	boolean		false	Enable more verbose output on error

---

Generated from au3 task --help and subcommand help output.