cleo delete
Aliases:cancel
Cancel/soft-delete a task with configurable child handling strategies
Agent Relevance: High - Frequently used by LLM agents
Synopsis
Options
| Option | Description |
|---|---|
--reason | Reason for operation (often required) |
--children | Handle child tasks |
--limit | Limit number of results |
--dry-run | Preview changes without applying |
--force | Force operation without confirmation |
--skip-reason | Skip reason requirement |
--format | Output format: text, json |
--human | Force human-readable output |
--json | Force JSON output |
--quiet | Suppress output, return only essential data |
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 |
4 | Resource not found | No |
6 | Validation error | No |
16 | Has children (use —children) | No |
17 | Task completed (use archive) | No |
102 | No change needed | No |
See Also
- Commands Index - Full command reference
- add - Create new tasks
- update - Modify tasks
- complete - Mark tasks done