cli + tui to publish to leaflet (wip) & manage tasks, notes & watch/read lists 馃崈
desertthunder.dev
charm
leaflet
readability
golang
1---
2title: Task Basics
3sidebar_label: Basics
4description: Create tasks and understand their core attributes.
5sidebar_position: 2
6---
7
8# Task Basics
9
10## Creation
11
12Create a simple task:
13
14```sh
15noteleaf task add "Write documentation"
16```
17
18Create a task with attributes:
19
20```sh
21noteleaf task add "Review pull requests" \
22 --priority high \
23 --project work \
24 --tags urgent,code-review \
25 --due 2025-01-15
26```
27
28## Properties
29
30**Description**: What needs to be done. Can be updated later with `task update`.
31
32**Status**: Task lifecycle state:
33
34- `pending`: Not yet started (default for new tasks)
35- `active`: Currently being worked on
36- `completed`: Finished successfully
37- `deleted`: Removed but preserved for history
38- `waiting`: Blocked or postponed
39
40**Priority**: Importance level affects sorting and display:
41
42- `low`: Nice to have, defer if busy
43- `medium`: Standard priority (default)
44- `high`: Important, should be done soon
45- `urgent`: Critical, top of the list
46
47**Project**: Group related tasks together. Examples: `work`, `home`, `side-project`. Projects create organizational boundaries and enable filtering.
48
49**Context**: Location or mode where task can be done. Examples: `@home`, `@office`, `@phone`, `@computer`. Contexts help filter tasks based on current situation.
50
51**Tags**: Flexible categorization orthogonal to projects. Examples: `urgent`, `quick-win`, `research`, `bug`. Multiple tags per task.
52
53**Due Date**: When the task should be completed. Format: `YYYY-MM-DD` or relative (`tomorrow`, `next week`).
54
55### Lifecycle
56
57Tasks move through statuses as work progresses:
58
59```
60pending -> active -> completed
61 |
62 v
63 waiting
64 |
65 v
66 deleted
67```
68
69**Mark task as active**:
70
71```sh
72noteleaf task update 1 --status active
73```
74
75**Complete a task**:
76
77```sh
78noteleaf task done 1
79```
80
81**Delete a task**:
82
83```sh
84noteleaf task delete 1
85```