qalatra/docs/Your first task

Your first task

Press n. Type. Press return. You're done.

Qalatra is keyboard-first. Everything you'll do in the next five minutes is reachable from the home row.

Create a task

Press n anywhere in the app. A modal opens with the cursor in the title field. Type the title, press Enter. Task created, modal closed, cursor back where it was.

If you want more structure, use the inline modifiers:

Review PR #482 #code @work !p1 ~45m ^Friday
ModifierMeaning
#tagAdds a tag
@contextSets context (work, personal, etc.)
!p1!p4Priority
~30m ~2hEstimated time
^dateDue date — natural language accepted (tomorrow, next Friday)
&agent-nameAssigns an agent (see Agents)

Edit a task

Select the task (j/k or click), then click to open the detail panel.

Complete a task

Select it, press c. Completed tasks fade out after 10 seconds into the archive, recoverable from the Backlog view.

Organize

  • 1Priority: today's focus, sorted by urgency + energy fit
  • 2Code
  • 3Reading
  • 4Projects: grouped by project
  • 5Backlog: everything else
  • 6Habits: your recurring rituals
  • 7Heartbeats

What next

You have a task list. Now let's give your agent access to it → Connect your first agent.