todo is a dead simple command-line tool for managing a task list.
Tasks are stored in a CSV file.
- Adding tasks
- Moving tasks between "todo" and "done" groups
- Searching tasks
- Removing tasks
- Commenting tasks
That's all. Really. No deadlines, no linking, no epics. No features are also a feature.
You need Rust toolchain to build todo from sources.
Follow this
instructions if you don't have one.
cargo install --git https://github.com/deliro/todoRun the CLI with one of the available commands:
todotodo list [status]Aliases: l, ls.
todo <task description>Example:
todo make a wishThis will create a task make a wish.
todo "watch https://www.youtube.com/watch?v=dQw4w9WgXcQ"Quotes are needed when your title have some "special" characters for your shell
todo todo <task>Alias: t.
todo done <task>todo drop <task>Aliases: remove, delete, rm.
todo remove-droppedtodo rename <task>todo find <task>todo detail <task>Alias: d.
todo comment <task>Alias: c.
This will open your $EDITOR if it's set or open the first found from the list:
nvim, vim, vi, nano
A comment can also be read from piped stdin:
cat somefile.txt | todo comment 123will add the whole somefile.txt to the task with ID=123
todo buy milk # Creates a task "buy milk"
todo list # Displays the task list
todo done buy milk # Marks "buy milk" as done
todo drop buy milk # Deletes "buy milk"The search is flexible. If you type todo comment 123, it will search for a task
with ID=123, if no task with this ID was found, todo will search for tasks that:
- Have
123in their title - Have
123in their comments - Have a similar word in their title or comments. Similar words are found using Jaro-Winkler similarity.
If multiple candidates are found, you'll be prompted for the certain ID of the task you're looking for
todo buy milk
todo buy beer
todo learn how to make beertodo find mlik # a mistake
[Todo]:
1. buy milktodo comment beer
Select ID:
[Todo]:
2. buy beer
3. learn how to make beertodo detail learning
Title: learn how to make beer
ID: 3
Status: Todo
----- comments -----
where to buy hops?
--------------------
created at: 2025-03-23T21:41:07.640567+03:00
updated at: 2025-03-23T21:43:05.604565+03:00It's a good idea to back up your tasks on a regular basis. Git is a perfect tool for that.
Do the following steps:
- Create an empty git repository somewhere (private GitHub repository for example)
cd $(dirname $(todo w))git initgit remote add origin git@github.com:your-username/repo-name.gitgit add tasks.csvgit commit -m "initial"git push -u origin master- run
which todoand remember the path crontab -e-
MAILTO="" 0 * * * * cd $(dirname $(/the/path/from/step-8 w)) && git diff --quiet || (git add tasks.csv && git commit -m " Auto-commit $(date +\%Y-\%m-\%d\ \%H:\%M:\%S)" && git push)
- save the crontab file (
ESC-Z-Zin case you're in vim/nvim/vi)
Now your tasks are backed up every hour if changes were made.
todo find updated before yesterday milk — find tasks that were updated before yesterday (including) and contains "
milk" or similar word
todo find created after 2025-05-04 till now — find tasks that were created between 2025-05-04 and today
todo find updated after 2 months ago
This project is distributed under the MIT License.