cleo list
Aliases:ls, tree
View tasks with filtering (status, priority, label, phase, type, parent)
Agent Relevance: Critical - Essential for LLM agent workflows
Synopsis
Options
| Option | Description |
|---|---|
--format | Output format: text, json |
--quiet | Suppress output, return only essential data |
--status | Filter by status |
--priority | Filter by priority |
--label | Filter by label |
--phase | Filter by phase |
--type | Filter by task type |
--parent | Filter by parent task ID |
--children | Handle child tasks |
--tree | Show hierarchical tree view |
This command supports JSON output via
--json flag for LLM agent integration.Examples
Exit Codes
| Code | Meaning | Recoverable |
|---|---|---|
0 | Success | No |
2 | Invalid arguments | No |
100 | No data/results | No |
See Also
- Commands Index - Full command reference
- show - Task details
- find - Search tasks