# taskwarrior aka `task`

cheatsheet: `/usr/share/doc/task/task-ref.pdf`


# config

    task show


# usage

    task <filter> <command> <modifications> <misc>

## filter

    task filter1 filter2            # defaults to `and`
    task filter1 or filter2
    task \( filter1 or filter2 \)   # prevent precedence fuckup
    task /sync/                     # search term can be delimited w/ `/`
    task /reg[ex]*p/
    task rc.regex:off /reg[ex]*p/   # turn off regexp
    task description~foo list       # search in desc
    task 'desc!~foo' list           # invert

## commands

-   `add`, `delete`
-   `append`, `prepend`: modify task by prepending/appending text
-   `count`: count tasks matching filter
-   `modify`
-   `edit`: interactive, uses `$EDITOR`
-   `start`, `stop`, `done`
-   `synchronize`: sync w/ server
-   `undo`

## advanced commands

-   `annotate`, `denotate`
-   `purge`: completely remove task rather than changing status to `deleted`

## reports

-   `active`: started tasks, also `+ACTIVE`
-   `blocked`, `blocking`
-   `list`, `long`, `ls`, `minimal`
-   `newest`, `oldest`
-   `overdue`
-   `ready`, `unblocked`: omit blocked tasks
-   `recurring`, `waiting`
-   `timesheet`: done-list for current week
-   `history`, `ghistory`
-   `information`: list all attributes

## contexts

    task context name   # enter context
    task context none   # leave context


# attributes

`attribute:value`

-   `depends:id`, `depends:-id`: add, remove dependency
-   `+tag`, `-tag`: add / remove `tag`, mustn't start w/ number
-   `+next`: special tag

## projects

-   `summary`: list project progress
-   `projects`: list projects w/ task count
-   `project:name`
-   `project:name.subname`
-   `project.not:name`

## priority

-   `priority`: values `H`/`M`/`L`, by default low is higher than none
-   regarding to doc `uda.priority.values  H,M,,L` should set `L` lower than
    none, but doesn't work for me, instead set
    `urgency.uda.priority.L.coefficient` to something negative

## dates

-   `due`: must be completed on
-   `scheduled`: when will be ready to work on, use `task ready` or `task +READY list`
-   `wait`: hide until, use `task waiting` to see hidden tasks
-   `until`: when task will auto expire
-   `entry`, `end`: creation, completion/deletion

### date filters

-   `due:today`, `+TODAY`
-   `due.any` and `due.none`
-   `+WEEK`, `+DUE`: this and next week
-   `+YESTERDAY`, `+TOMORROW`, `+MONTH`, `+YEAR`

### date format and names

-   iso is supported
-   `5s`, `5 s`, `5sec`, `5seconds`: don't think too much
-   `min`, `h`, `d`, `w`, `m`, `y`: "m" in month
-   `now`, `today`
-   `yesterday`, `tomorrow`
-   `eod`, `sod` (end/start of day)
-   `monday`, `tuesday`, ... next matching day
-   `january`, `february`, ... next matching start of month
-   `later`, `someday`: far future
-   `soy`, `eoy` (start/end of year)
-   `soq`, `eoq` (start/end of quarter)
-   `som`, `eom` (start/end of month)
-   `sow`, `eow` (start/end of week)
-   `soww`, `eoww` (start/end of work week)
-   `1st`, `2nd`, ... (next nth of month)

"start" usually refers to next month, year, ..., unless `c` for current is
given, like `socm`.


# virtual tags

-   `LATEST`, last task added
-   `TODAY`, don't `task due:today` which matches only 00:00:00
-   `BLOCKED`, `UNBLOCKED`, `BLOCKING`
-   `ACTIVE`, `READY`, `PENDING`
-   `SCHEDULED`, `UNTIL`, `WAITING`
-   `PARENT`, `CHILD`: something with recurring
-   `COMPLETED`, `DELETED`
-   `PRIORITY`, `PROJECT`


# configure urgency

    # make `+bug` more urgent
    task config urgency.user.tag.bug.coefficient 4.5
    # make `+later` less urgent
    task config urgency.user.tag.later.coefficient -6.0
    # boost given project
    task config urgency.user.project.Home.coefficient 2.9
    # nullify effect of being blocked
    task config urgency.blocked.coefficient 0.0


# tools

-   tasknc: ncurses interface, broken or slow
-   bugwarrior: pull issues from github

web ui:
~/.gem/ruby/2.4.0/bin/task-web

## `tasksh`

a shell wrapper that
-   includes every command
-   introduces `review` (once a week)
-   review kinda breaks shell history