1.7 KiB
Raw Permalink Blame History


Hackage Deps CI Packaging status


Taskwarrior is a feature rich command-line task management tool.

This Haskell library contains

  • a data type to represent a taskwarrior task
  • Aeson instances to deserialize and serialize a task according to the taskwarrior import/export specifications
  • IO actions to load and manipulate tasks by calling the task command. (Since this is the encouraged way to library design by the taskwarrior developers.)


Install taskwarrior from hackage. Have a look at Taskwarrior.IO.getTasks to get started.

This example prints the description of (at the most) 5 pending tasks.

import Taskwarrior.IO (getTasks)
import Taskwarrior.Task as Task

main :: IO ()
main = do
  tasks <- getTasks ["+PENDING", "limit:5"]
  print $ Task.description <$> tasks


Any form of issue reports, general feedback, feature requests or suggestions and of course code contributions are highly welcome.

Also I'd be curious to know what you use this library for.

This project uses fourmolu as code formatter.

Help & Contact

You can always open an issue on GitHub. Contacting @maralorn:maralorn.de on matrix is also an option. But of course that wont be public and therefore not help anyone else.