check

todoister check [flags] [#][PARENT/.../PROJECT] TASK

Mark a TASK in a PROJECT as completed.

Use #[PARENT/SUBPARENT…/]PROJECT to specify the project name with optional PARENT and SUBPARENTS (note the ’#’ character prefix and the single quotes).

Alternatively, you can use the —project flag to specify the project name and omit the ’#’ prefix and the quotes.

You can identify a TASK by its partial name: any task whose name starts with the text you type is a match, so ‘Write’ matches ‘Write report’. Matching is case-insensitive and only considers tasks that are not yet completed.

If multiple tasks match, an error is shown with a list of matching tasks and nothing is marked as completed; use a longer prefix to single out one task.

Flags

-p, --project <string>

project name or path (e.g., 'Work' or 'Work/Reports')

Global Flags

-t, --token <string>

use <string> as Todoist API token

Examples

  # Check a task in a root project
  todoister check '#Work' 'Write report'
  todoister check -p Work 'Write report'

  # Check a task in a nested project
  todoister check '#Work/Reports' 'Q4 summary'
  todoister check -p Work/Reports 'Q4 summary'

  # Check a task using a partial name
  todoister check '#Work/Reports' 'Q4'
  todoister check -p Work/Reports 'Q4'