NAME

Taskwarrior::Kusarigama::Plugin::Command::Progress - Record progress on a task

VERSION

version 0.12.0

SYNOPSIS

$ task add read ten books goal:10

... later on ...

$ task 'read ten books' progress

DESCRIPTION

Tasks get two new UDAs: goal, which sets a numeric goal to reach, and progress, which is the current state of progress.

Progress can be updated or asked via the progress command.

# add 3 units toward the goal
$ task 123 progress 3

# oops, two steps back
$ task 123 progress -2

# set progress to an absolute value
$ task 123 progress =9

# defaults to a +1 increment
$ task 123 progress

# record progress and add a note
$ task 123 progress +3 I did a little bit of the thing

# ask about current task progress
$ task 123 progress ?

# ask about current task progress on three step forward
# real progress don't modified
$ task 123 progress ?3

If the task has a due date, the progress command will also show a short report of your actual rate of completion version what is required to meet the goal on time.

$ task 630 progress =170
630 =======------------ 170/475 (35.8%)
15 days left, you are ahead of schedule (170 vs 118)
rate so far: 34/day, rate needed: 20/day

AUTHOR

Yanick Champoux <yanick@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2019, 2018, 2017 by Yanick Champoux.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.