Skip to content

Quick Start

Wylie Standage-Beier edited this page Dec 8, 2025 · 1 revision

Quick Start

Learn the basics of TaskFlow in 5 minutes.


Launch TaskFlow

# With empty task list
taskflow

# With demo data (recommended for first time)
taskflow --demo

Step 1: Create a Task

  1. Press a to add a new task
  2. Type: Buy groceries #errands due:tomorrow
  3. Press Enter

You've created a task with a tag (#errands) and due date using Quick-Add-Syntax!


Step 2: Navigate

Key Action
j or Move down
k or Move up
g Jump to first task
G Jump to last task

Step 3: Complete a Task

  • Select a task and press x or Space
  • The task is marked as done [x]
  • Press again to uncomplete

Step 4: Change Priority

Press p to cycle through priority levels:

None → Low (!) → Medium (!!) → High (!!!) → Urgent (!!!!) → None

Step 5: Create a Project

  1. Press P (capital P)
  2. Type a project name: Home
  3. Press Enter

The project appears in the sidebar.


Step 6: Move Task to Project

  1. Select a task
  2. Press m to move
  3. Select your project
  4. Press Enter

Step 7: Use the Sidebar

  1. Press h to focus the sidebar
  2. Use j/k to navigate views
  3. Press Enter to select a view
  4. Press l to return to task list

Available Views

  • All Tasks - Everything
  • Today - Due today
  • Upcoming - Future due dates
  • Overdue - Past due dates
  • Calendar - Monthly view
  • Dashboard - Statistics

Step 8: Get Help

Press ? to show all keybindings.

Press ? again or Esc to close.


Step 9: Save and Quit

  • Press Ctrl+s to save manually
  • Press q to quit (auto-saves)

Essential Keybindings

Key Action
a Add task
e Edit title
x Toggle complete
d Delete task
p Cycle priority
/ Search
? Help
q Quit

Next Steps

Clone this wiki locally