Todo.txt – Manages Your Todo Tasks from Linux Terminal

Todo.txt (todo.txt-cli) is an easy and extensible shell script for managing your todo.txt file. It allows you to add todos, list added todos, mark an entry as done, appends text to existing lines, and remove duplicate lines from todo.txt all from the Linux command line.

It also supports archiving (moves all done tasks from todo.txt to done.txt and removes blank lines), de-prioritizing (removes the priority) from the task(s) and so much more.

Todo.txt-cli is part of the todo.txt apps which are minimal, open source and cross-platform, todo.txt-focused editors which assist you manage your tasks with a few keystrokes and taps possible. Todo.txt CLI and Todo.txt Touch are built for CLI, iOS, and Android.

 Todo.txt CLI Demo
Todo.txt CLI Demo

How to Install Todo.txt CLI in Linux

To install todo.txt-cli, first you need to clone the git repository on your system using following git command.

$ cd ~/bin
$ git clone
$ cd todo.txt-cli/

Then run the following commands to build and install todo.txt-cli.

$ make
$ sudo make install

Note: The Makefile makes several default paths for installed files. You can use the following variables to make adjustments on your system:

  • INSTALL_DIR: PATH for executables (default /usr/local/bin).
  • CONFIG_DIR: PATH for todo.txt config.
  • BASH_COMPLETION: PATH for auto-completion scripts (default to /etc/bash_completion.d).

For example:

$ make install CONFIG_DIR=$HOME/.todo INSTALL_DIR=$HOME/bin BASH_COMPLETION_DIR=/usr/share/bash-completion/completions
Install Todo.txt CLI in Linux
Install Todo.txt CLI in Linux

How to Use Todo.txt CLI in Linux

To add a todo task to your todo.txt file, run the following commands.

$ sudo add "setup new linode server"
$ sudo add "discuss site with Ravi"
Add Todo Tasks in Linux Terminal
Add Todo Tasks in Linux Terminal

To list added todo tasks, use the following command.

$ ls
List Todo Tasks in Linux Terminal
List Todo Tasks in Linux Terminal

You can marks task as done in todo.txt using following command.

$ sudo do 1
Mark Todo Task as Done
Mark Todo Task as Done

You can also delete a todo item, for example.

$ sudo del 1
Delete a Todo Task in Linux
Delete a Todo Task in Linux

For more usage and command options, run the following command.

$ -h

Todo.txt Homepage:

That’s all! Todo.txt is a simple shell script for creating and managing all your tasks from the Linux terminal. Share your thoughts about it or ask any questions via the feedback form below.

Tutorial Feedback...
Was this article helpful? If you don't find this article helpful or found some outdated info, issue or a typo, do post your valuable feedback or suggestions in the comments to help improve this article...

If You Appreciate What We Do Here On TecMint, You Should Consider:

TecMint is the fastest growing and most trusted community site for any kind of Linux Articles, Guides and Books on the web. Millions of people visit TecMint! to search or browse the thousands of published articles available FREELY to all.

If you like what you are reading, please consider buying us a coffee ( or 2 ) as a token of appreciation.

Support Us

We are thankful for your never ending support.

6 thoughts on “Todo.txt – Manages Your Todo Tasks from Linux Terminal”

  1. You’re using sudo to run a command that requires no special privileges. That’s probably the worst example one could set


Got something to say? Join the discussion.

Have a question or suggestion? Please leave a comment to start the discussion. Please keep in mind that all comments are moderated and your email address will NOT be published.