Metadata-Version: 2.1
Name: taskwarrior_flow
Version: 0.4.0
Summary: Set of helpers for improving Taskwarrior workflow
Author: Ben Trinh
Author-email: huantrinh1802@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: dateparser (>=1.2.0,<2.0.0)
Requires-Dist: python-dateutil (>=2.8.2,<3.0.0)
Requires-Dist: questionary (>=2.0.1,<3.0.0)
Requires-Dist: typer (>=0.12.3,<0.13.0)
Description-Content-Type: text/markdown

# 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)

