A command-line tool to manage todo list and record time spent on tasks.
Pomodoro-warriors is the integration of taskwarrior and timewarrior which helps you to:
python2 bootstrap.py
;Take OneDrive as an example and suppose you've already installed both taskwarrior and timewarrior:
python2 bootstrap.py ~/OneDrive/task
Since pomodoro-warriors is the integration of taskwarrior and timewarrior, the following usages go with the hypothesis that the readers are skilled at both of them.
task <id> split <mods>
Create a new subtask with <mods>
which blocks the former one.
If a project name is given to the subtask. The project name of the parent task is prepended to it to make it in hierarchy.
Else, the project name of the subtask is simply inherited from the parent task.
Therefor, a task with no project cannot be splitted.
For example.
>>> task add project:test "I'm a parent task"
Created task 1.
>>> task 1 split +next "I'm a child task"
Created task 2.
>>> task 1 split project:sub "I'm another child task"
Created task 3.
>>> task _get 1.depends
b4eb87e6-54f5-422e-939a-f03c673de23e,8dd2e258-525f-4ff0-a7dc-b80fbca8387c
>>> task _get {2,3}.project
test test.sub
task <id> timew ...
This is a shortcut to execute timew ... <task tags, projects, uuid>
which makes the tracking and reporting of tasks much more convenient.
E.g. task <id> timew start
.
Tracking with a special tag pomodoro
tells timewarrior that you are in Pomodoro Mode.
So you can start a Pomodoro when doing a specific task by executing task <id> timew start pomodoro
.
timew last
. Show info of current tracking or last tracked task.timew pomo_stat
. Export statistics on Pomodoro Mode.timew pomo_msg
. Show current state in Pomodoro Mode. Can be integrated with tmux
or powerline
.timew duration
. Output the total duration.If you are using tmux you can append the following line to ~/.tmux.conf
:
set-option -g status-left "#(timew pomo_msg.py :day)"
If you are using powerline you can add this to the segments:
{
"function": "powerline.lib.shell.run_cmd",
"priority": 80,
"args": {
"cmd": ["timew", "pomo_msg.py", ":day"]
}
}
See branch ks to view my personal reports as examples.
task <filter> tiny
. Display tasks in tiny spaces like panes in tmux.estimate
to store an estimate for the costing duration of a task.timew toggle [<tag> ...]
. Start a new track with tags appended to / removed from the tags of current track.Mainly it's the combination of the GTD Theory and the Pomodoro Technology.
task add <desc>
task -PROJECT
and process the pieces one by one;task <id> annotate <anno>
(or description if it's short) and set project, priority, scheduled, due, etc with task <id> modify <mods>
;task <id> split <mods>
. The more actionable the subtasks are the better;task <id> modify estimate:<duration>
.task <id> start
or add due dates to make the tasks obvious in your task list.task <id> timew start
. Start a task and track it.timew stop
. Stop tracking a task.task <id> done
. Complete a task and stop tracking it.task <id> timew start pomodoro
. Start a pomodoro on a task.timew toggle pomodoro
or timew stop pomodoro
. Stop a pomodoro and keep tracking the task.task <id> modify +next
to boost its urgency. After the current pomodoro, handle it.timew day
timew week