Skip to content

taskwarrior

The community/apps/taskwarrior directory contains a single file, taskwarrior_linux.talon, which provides voice commands for interacting with the Taskwarrior command-line task management application on Linux.

The file defines a series of voice commands that map to Taskwarrior commands. Here is a breakdown of the most important commands:

  • task version: Executes task --version and returns the version of Taskwarrior installed.
  • task commands: Executes task commands and returns a list of all Taskwarrior commands.
  • task help: Executes task help and displays the Taskwarrior help information.
  • task list: Executes task list and shows the list of tasks. There are several variants:
    • task list orphans: Executes task project: list and shows a list of tasks that don't belong to a project.
    • task list untagged: Executes task tags.none: list and shows a list of tasks that don't have tags.
    • task list <user.text>: Executes task list {text} where {text} is a spoken word or phrase, allowing users to filter the task list.
    • task list project: Executes task list project: which allows a user to say the project to list.
    • task list project <user.text>: Executes task list project:{text} where {text} is a spoken project name to list.
  • task add: Executes task add to prepare for adding a new task.
  • task add <user.text>: Executes task add {text} where {text} is a spoken description of the new task.
  • task undo: Executes task undo to undo the last change.
  • (tasks | task next): Executes task next to show the next task in the list.
  • task <number> edit$: Executes task {number} edit where {number} is a spoken number, allowing the user to edit the task of that ID.
  • task <number> done$: Executes task {number} done where {number} is a spoken number, marking that task complete.
  • task <number> delete$: Executes task {number} delete where {number} is a spoken number, deleting the given task.

In summary, this file provides a set of voice commands to manage tasks with Taskwarrior, covering common operations like listing, adding, editing, completing and deleting tasks. The user can perform these operations using voice control.