Want to get things done? Pick a task, do it, and move on to the next one.
toddi
will tell you exactly what to focus on, per project, based on your
todo.txt
tasks.
Why not?
I've been using todo.txt
regularly for a few months, and I noticed that:
Hence, toddi
. I'm building it to fit my purpose.
Which also turned out to be a good excuse to practice some Rust.
Built around todo.txt
data.
todo.txt
data sourcestoddi
follows loosely todo.txt
's task format and is capable of completing
tasks on its own.
By default, the program assumes the default todo.txt
paths in the absence of
the relevant optional input:
~/.todo-txt/todo.txt
~/.todo-txt/done.txt
The format for a task line should conform to todo.txt
documentation.
E.g.:
(PRIO) Task's short description +project @context
The priority (PRIO)
field is a single capital letter enclosed within
parenthesis. Only one is allowed.
The task description field is a contiguous alphanumerical space-separated
multiple-word sentence. It tolerates the following special non-alphanumerical
characters: . _ - '
(i.e. dot, underscore, dash and apostrophe). Any other
will invalidate the line.
The project field is an alphanumerical single word preceded by a +
(plus)
sign. Only one is allowed.
The context field is an alphanumerical single word preceded by a @
(at) sign.
Only one is allowed.
The context and project fields can switch place between each other.
The format for a done line looks like this:
x YYYY-MM-DD Task's short description +project @context
Note the x
on the left.
If you trust your planning and just need a way to focus on the next task, use:
$ toddi
Display next todo.txt
task for projects fleur
and banane
(i.e. +fleur
and +banane
on the task line) and a progress bar indicating the project's
level of completion:
$ toddi projects fleur banane
Focus on the task (do not return to the shell) and queries you on whether the task is complete or not. Can be used with either one or no project name.
$ toddi focus
$ toddi focus fleur
Use --help
for more information:
$ toddi --help
A TOML configuration file is expected at the standard XDG_CONFIG_HOME location:
$HOME/.config/toddi/config.toml
If not present, it will be automatically created and populated with mandatory default values on first use.
todo_files = ["/home/user/.todo-txt/todo.txt"]
source : GPL-3.0-or-later