This repo has moved to http://www.codeberg.org/milofultz/tod_sh
A simple pomodoro task manager in shell scripts.
A pomodoro is a 25 minute chunk of uninterrupted time, followed by a 5 minute break. If this is uninterrupted, it will add a pomodoro to the task. If interrupted, it will not add a pomodoro to the task.
This is a rewrite and devolution more or less of my Python task manager, Tod.
- Manages tasks to do
- Tracks how many pomodoros you have done using asterisks after the task name
Clone the repo somewhere that it can be referenced by your shell. In your shell's rc file, add an alias of tod=./path/to/tod.sh so you can use it wherever.
This uses SoX for the alarm, which can be installed using Homebrew on Mac.
Tod is used in the command line via whatever alias you created. For instance, if you set an alias to tod, then you would add a task with tod a "New task", start a pomodoro timer with tod 1, list all tasks with tod la, etc.
A task is a line of text with possible modifiers. The following are all allowed:
A normal taskx Completed task(A) High priority task!Project task +projectnamex (C) A completed high priority project task +ford-prefect
x Completed task- Anxrepresents completion.(A) High priority task!- A set of parentheses with a single letter inside represents priority, A to Z representing highest to lowest.
Project task +projectname- A+followed by a name with no spaces.
| Flag | Arguments | Description |
|---|---|---|
n |
n: Task number |
Start pomodoro timer |
N/A / ls |
List all uncompleted tasks | |
a "task"[ "another task" ...] |
task: New task |
Add new task |
b |
Start break timer | |
c n[ n ...] |
n: Task number |
Mark task as complete/incomplete |
d n[ n ...] |
n: Task number |
Delete task |
e |
Open .tod file for editing |
|
k |
Kill timers | |
la |
List all tasks | |
lc / c |
List all completed tasks | |
lp |
List all priority tasks | |
p[ "project"] |
project: Project name |
List all tasks belonging to project |
t |
See elapsed time for timer |