taskwarrior
This directory provides voice command integration for Taskwarrior, a popular command-line task management tool. This integration allows users to efficiently manage their tasks, queries, and task lists directly through terminal-based voice commands.
Voice Commands for Taskwarrior
The core functionality is defined in the following file:
- taskwarrior_linux.talon: Implements Taskwarrior commands for Linux systems running in a terminal emulator. It requires both the
terminaltag and theuser.taskwarriortag to be active.
Command Reference and Usage
The voice commands in this module cover the lifecycle of task management and are grouped into several logical areas:
- General Information: Commands like "task version" and "task help" quickly print version information or help documentation to the terminal.
- Task Listing and Filtering: Users can list tasks using various filters. Commands include "task list" to view active tasks, "task list orphans" to view tasks without an associated project, and "task list untagged" for tasks lacking tags. You can also target specific projects using commands like "task list project <user.text>".
- Adding and Undoing Tasks: Creating tasks is streamlined via "task add <user.text>", which appends the spoken text directly to the command line and executes it. An accidental command can be quickly reverted with "task undo".
- Task Modification and Completion: Specific tasks can be edited, completed, or deleted by targeting their ID number (e.g., saying "task <number> done" or "task <number> delete").