How to use TodoTXT

Writing a todo

Each todo is a single line of text. Just type what you need to do and hit enter.

Buy groceries
Simple todo, no extras

Priority

Start with a letter and a dash to set urgency. A- is the most urgent, D- is low priority.

A- Fix the login bug
Urgent priority (A)
C- Read that article
Medium priority (C)

The colored bar next to each todo shows its priority level.

Projects (tags)

Add +ProjectName anywhere in your todo to tag it with a project. You can have multiple projects on one todo.

A- Fix login bug +AppV2 +Backend
Tagged with two projects

The project prefix (+ by default) can be changed in Settings. Some people prefer # or /.

You can even write them without spaces: +Work+Urgent creates two tags.

Contexts

Add @context to note where or how you will do something.

Call dentist @phone
Do this when you have your phone

The context prefix (@ by default) is also customizable in Settings.

Metadata

Add key:value pairs for extra info like due dates.

A- Submit report +Work due:2026-04-01
Due date as metadata

Gestures

This app is designed for your thumb. Everything is a tap or swipe.

TapOpens a fan of action icons right where you tapped — complete, edit, tag, or delete.
Swipe rightMark a todo as done (or undo it). You will feel a small vibration at the threshold.
Long pressEnter selection mode. Tap more todos to select them, then use the bar at the bottom for bulk actions.

The arc menu

When you tap a todo, four icons fan out in a semicircle below your finger:

  • Check — mark as done
  • Pencil — edit the todo inline (the row expands into an input)
  • Tag — add or remove project tags
  • Trash — delete (you can undo this)

Batch actions

Long-press any todo to enter selection mode. Then tap others to select them. A bar appears at the bottom with:

  • Select all — selects every visible todo
  • Complete — marks all selected as done
  • Tag — add a project to all selected
  • Delete — removes all selected

Selected todos show a strikethrough so you can see what will be affected.

Undo and redo

Every action is recorded. The undo and redo buttons in the bottom bar let you step backward and forward through up to 1,000 changes.

On desktop: Ctrl+Z to undo, Ctrl+Shift+Z to redo (only when you are not typing in an input).

Project colors

Each project gets a color and a letter badge on the right side of the todo row. Tap the badge to change the project's emoji, color, or name.

Keyboard shortcuts

All shortcuts are customizable in Settings. Defaults:

UndoCtrl + Z
RedoCtrl + Shift + Z
Focus inputCtrl + K
Accept autocompleteTab

On Mac, Ctrl becomes .

Settings file format

You can export and import your settings as a JSON file from the Settings page. The file looks like this:

{
  "projectPrefix": "+",
  "contextPrefix": "@",
  "shortcuts": {
    "undo": "mod+z",
    "redo": "mod+shift+z",
    "focusInput": "mod+k",
    "newTodo": "mod+n"
  }
}
  • projectPrefix — single character for tagging projects
  • contextPrefix — single character for contexts
  • shortcuts — key combos using mod (Ctrl/⌘), shift, alt + a key

Import the file on another device to sync your preferences.

TodoTXT PWA — offline-first, gesture-driven