https://github.com/huantrinh1802/taskwarrior_flow
CLI to improve Taskwarrior workflow
https://github.com/huantrinh1802/taskwarrior_flow
cli-tools python taskwarrior
Last synced: 8 months ago
JSON representation
CLI to improve Taskwarrior workflow
- Host: GitHub
- URL: https://github.com/huantrinh1802/taskwarrior_flow
- Owner: huantrinh1802
- License: apache-2.0
- Created: 2024-05-03T03:28:50.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-26T06:58:59.000Z (over 1 year ago)
- Last Synced: 2025-04-08T13:54:02.193Z (10 months ago)
- Topics: cli-tools, python, taskwarrior
- Language: Python
- Homepage:
- Size: 73.2 KB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Taskwarrior Flow (TWF)
Taskwarrior Flow (TWF) is a plugin designed to enhance your Taskwarrior workflow by providing a set of utilities accessible via the command-line interface (CLI). Whether you're managing tasks, creating queries, or working with templates, TWF aims to streamline your Taskwarrior experience.
## Installation
### Using pipx
```shell
pipx install taskwarrior_flow
```
## Usage
Please see the [USAGE.md](./USAGE.md) for more information
## Features
### Query
Allow users to save common queries that can be used to search tasks easily.
For example, `project:Work +scopeA +scopeB due:today+2days`
### Task template
Allow users to save templates that can be used to create tasks easily
### Multiple task groups
Instead of having one task database (i.e. $HOME/.task/), using `twf [GROUP] [Taskwarrior commands]` will allow users to use different task databases (i.e. $HOME/.task_[GROUP])
### Natural date parsing
Users can specify dates in natural language, such as "tomorrow", "next week", "last year", etc.
- In the template, users can define fields to be date, this enables natural date parsing
- In task group, users can use a special syntax to specify dates, such as `due:@tomorrow at 2pm@`
## Related tools
- This CLI is a complementary tool for [taskwarrior](https://taskwarrior.org)
- This CLI is designed to work well with my [taskwarrior Neovim Plugin](https://github.com/huantrinh1802/m_taskwarrior_d.nvim)