Task Management

Task Management

Complete guide to creating, editing, and managing tasks.

---

Creating Tasks

Basic Creation

1. Press a to open task input
2. Type your task title
3. Press Enter to create

With Quick Add Syntax

Create tasks with metadata in one line:

Fix login bug #bug !urgent due:today @Backend

See Quick-Add-Syntax for full syntax reference.

---

Editing Tasks

Edit Title

1. Select a task
2. Press e
3. Modify the title
4. Press Enter to save, Esc to cancel

Edit Due Date

1. Select a task
2. Press D
3. Enter date (YYYY-MM-DD or keywords like tomorrow)
4. Leave blank to clear

Edit Tags

1. Select a task
2. Press T
3. Enter comma-separated tags: work, urgent
4. Leave blank to clear all tags

Edit Description

1. Select a task
2. Press n
3. Enter or modify description
4. Press Enter to save

---

Task Properties

Priority

Press p to cycle through priorities:

Symbol	Priority
(blank)	None
!	Low
!!	Medium
!!!	High
!!!!	Urgent

Status

Symbol	Status	Description
[ ]	Todo	Not started
[~]	In Progress	Being worked on
[!]	Blocked	Waiting on something
[x]	Done	Completed
[-]	Cancelled	No longer needed

Press x or Space to toggle between Todo ↔ Done.

---

Completing Tasks

Single Task

• Select and press x or Space
• Task moves to Done status
• Hidden if "hide completed" is active

Recurring Tasks

When you complete a recurring task:

1. Current task marked Done
2. New task created with next due date
3. New task appears in your list

See Recurring-Tasks for setup.

---

Deleting Tasks

1. Select the task
2. Press d
3. Confirm in the popup

Notes:

• Deletion can be undone with u
• Tasks with subtasks must have subtasks deleted first

---

Multi-Select & Bulk Operations

Enter Multi-Select Mode

1. Press v to enter mode
2. Navigate with j/k
3. Press Space to toggle selection
4. Selected tasks show ●

Bulk Actions

Key	Action
d	Delete all selected
m	Move all to project

Quick Select

• Press V to select all visible tasks
• Press v or Ctrl+v to exit mode

---

Task Templates

Create tasks from predefined templates:

1. Press Ctrl+n to open picker
2. Navigate with j/k or press number
3. Press Enter to create
4. Edit the generated title

Built-in Templates

Template	Priority	Tags
Bug Fix	High	#bug
Feature	Medium	#feature
Review	Medium	-
Meeting Notes	Low	#meeting
Daily Task	Low	-
Weekly Task	Low	-
Urgent	Urgent	#urgent
Research	Low	#research

---

Viewing Task Details

View comprehensive information about any task:

Opening the Detail Modal

1. Select a task
2. Press i or Enter
3. A scrollable modal appears with all task information

Modal Contents

• Header: Title, status icon, priority indicators
• Metadata: Project, tags, task ID
• Dates: Created, updated, due, scheduled, completed
• Description: Full task description
• Time Tracking: Estimated vs actual time
• Subtasks: Progress and status
• Dependencies: Blocking tasks
• Time Entries: Recent tracking sessions
• Work Logs: Notes with timestamps

Navigation in Modal

Key	Action
j / ↓	Scroll down
k / ↑	Scroll up
g	Jump to top
G	Jump to bottom
PgUp / PgDn	Page scroll
Esc / q	Close

---

Subtasks

Create hierarchical task structures:

1. Select parent task
2. Press A (capital A)
3. Enter subtask title
4. Press Enter

See Subtasks-and-Dependencies for more.

---

Moving Tasks

To a Project

1. Select task
2. Press m
3. Choose project
4. Press Enter

Reordering

Custom ordering is maintained within views.

---

Keybindings Summary

Key	Action
a	Add task
A	Add subtask
e	Edit title
i	View task details
Enter	View details / Select
d	Delete
x / Space	Toggle complete
p	Cycle priority
D	Edit due date
T	Edit tags
n	Edit description
m	Move to project

---

See Also

• Quick-Add-Syntax - Advanced task creation
• Projects - Organizing with projects
• Subtasks-and-Dependencies - Task hierarchies
• Recurring-Tasks - Repeating tasks