Calendar

Calendar

View tasks in a monthly calendar format.

---

Accessing Calendar

Select "Calendar" from the sidebar.

---

Calendar Display

┌─────────────────────────────────────────┐
│           December 2025                 │
├─────┬─────┬─────┬─────┬─────┬─────┬─────┤
│ Sun │ Mon │ Tue │ Wed │ Thu │ Fri │ Sat │
├─────┼─────┼─────┼─────┼─────┼─────┼─────┤
│     │  1  │  2  │  3• │  4  │  5• │  6  │
│  7  │  8• │  9  │ 10  │ 11  │ 12  │ 13  │
│ 14  │ 15  │[16]•│ 17  │ 18  │ 19  │ 20  │
│ 21  │ 22  │ 23  │ 24• │ 25  │ 26  │ 27  │
│ 28  │ 29  │ 30  │ 31  │     │     │     │
└─────┴─────┴─────┴─────┴─────┴─────┴─────┘

Indicators

Symbol	Meaning
•	Day has tasks
[16]	Selected day
Red	Overdue tasks

---

Navigation

Key	Action
h / ←	Previous day
l / →	Next day
j / ↓	Next week
k / ↑	Previous week
<	Previous month
>	Next month

---

Viewing Day's Tasks

1. Navigate to a day with tasks (shows •)
2. Press Enter to focus the task list
3. View/edit tasks for that day
4. Press Esc to return to calendar

---

Task List Panel

When a day is selected, a panel shows that day's tasks:

┌─ December 16 ─────────────────────┐
│ !!!! [ ] Fix critical bug         │
│ !!!  [ ] Team meeting             │
│ !!   [ ] Review PR                │
└───────────────────────────────────┘

---

Task Actions in Calendar

While focused on the task list:

• j/k - Navigate tasks
• x - Toggle complete
• e - Edit task
• d - Delete task
• All standard task operations work

---

Tips

1. Plan ahead - Navigate to future dates to see upcoming work
2. Identify busy days - Days with many dots need attention
3. Quick add - Press a with a day selected to add a task for that date
4. Review overdue - Red highlights show what needs attention

---

Keybindings Summary

Key	Action
← / →	Previous/next day
↑ / ↓	Previous/next week
< / >	Previous/next month
Enter	Focus task list
Esc	Return to calendar

---

ICS Calendar Import

TaskFlow can import events from ICS calendar files. The mapping from ICS properties to calendar events:

ICS Property	Event Field	Notes
SUMMARY	title	Event name
DTSTART	start	Start date/time
DTEND	end	End date/time
DESCRIPTION	description	Event details
LOCATION	location	Where the event occurs
STATUS	status	Tentative, Confirmed, or Cancelled
UID	uid	Unique identifier for deduplication

Event Statuses

Status	Meaning
Tentative	Event is proposed but not yet confirmed
Confirmed	Event is definitely happening (default)
Cancelled	Event was scheduled but has been cancelled

Multi-Day Events

Events spanning multiple days will appear on each day in the calendar view.

---

See Also

• Views-and-Filtering - Other views
• Task-Management - Task operations
• Quick-Add-Syntax - Creating tasks with dates
• Import-Export - Import/export options