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 https://github.com/todotxt/todo.txt-cli.git
$ 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 todo.sh add "setup new linode server"
$ sudo todo.sh add "discuss fosswork.com site with Ravi"
Add Todo Tasks in Linux Terminal

Add Todo Tasks in Linux Terminal

To list added todo tasks, use the following command.

$ todo.sh 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 todo.sh do 1
Mark Todo Task as Done

Mark Todo Task as Done

You can also delete a todo item, for example.

$ sudo todo.sh del 1
Delete a Todo Task in Linux

Delete a Todo Task in Linux

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

$ todo.sh -h

Todo.txt Homepage: http://todotxt.org/

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.

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.

Aaron Kili

Aaron Kili is a Linux and F.O.S.S enthusiast, an upcoming Linux SysAdmin, web developer, and currently a content creator for TecMint who loves working with computers and strongly believes in sharing knowledge.

Your name can also be listed here. Got a tip? Submit it here to become an TecMint author.

RedHat RHCE and RHCSA Certification Book
Linux Foundation LFCS and LFCE Certification Preparation Guide

You may also like...

2 Responses

  1. 01101001b says:

    A really interesting tool to keep in mind. Thanks for the info!

  2. Mauricio López says:

    It seems to be a useful tool. Thanks for the tip.

    One question: why did you use sudo to add tasks?

Got something to say? Join the discussion.

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.