Todo.txt-cli

Open source

Shell script, todo.sh, for managing a plain-text todo.txt task file from the command line, with archiving and tab completion.

Open-source alternative to

todotxt.org
Todo.txt-cli homepage screenshot
GitHub stars
6.2k
Last 30 days
+12(+0%)
Last commit
7 days ago
Repository age
17 years
Version
v2.14.0
Licence
GPL-3.0
Self-hosted
Yes

About Todo.txt-cli

Todo.txt CLI is the command-line tool for the todo.txt approach: tasks live in an ordinary text file that you control. The script, called todo.sh, gives quick Unix-style access to that file from a terminal.

It supports archiving completed tasks to done.txt and tab autocompletion for priorities and contexts. The todo.txt format itself is a short set of rules that people and programs can both read, covering priorities, creation and completion dates, projects and contexts.

Because the data is plain text, it can be opened in any text editor on any operating system. The project also publishes official mobile apps, Todo.txt Touch, which syncs through Dropbox, and lists community apps for Windows, Mac, Ubuntu and cross-platform use. The CLI is open source and licensed under GPL-3.0.

Key features

  • todo.sh shell script for the command line
  • Archives completed tasks to done.txt
  • Format covers priorities, dates, projects and contexts
  • Plain-text file usable in any editor

Good fit for

  • Terminal task management
  • Keeping tasks in a portable text file
  • Scripting around a todo list
Built with
Shell tools
Tags
todo list
command line
plain text
task management
shell
productivity

Todo.txt-cli: questions and answers

What is Todo.txt-cli used for?
Todo.txt-cli is a shell script, todo.sh, for managing a plain-text todo.txt task file from the command line, with archiving and tab completion. It is a good fit for terminal task management, keeping tasks in a portable text file and scripting around a todo list.
Is Todo.txt-cli open source?
Yes. Todo.txt-cli is open source under the GPL-3.0 licence. Its source code is on GitHub at todotxt/todo.txt-cli and is written mainly in Shell.
Is Todo.txt-cli free?
Yes. Todo.txt-cli is open source, so the software itself is free to use.
Can I self-host Todo.txt-cli?
Yes. Todo.txt-cli can be self-hosted on your own server or infrastructure.
What is Todo.txt-cli an alternative to?
Todo.txt-cli is an open-source alternative to Microsoft To Do and Remember The Milk. Other open-source alternatives to Microsoft To Do include TaskTrove, Tududi and Super Productivity.
Is Todo.txt-cli actively maintained?
Yes. The most recent commit to Todo.txt-cli was on 6 November 2026, and the latest release is v2.14.0, published on 1 September 2026. The project has 6.2k stars on GitHub, with 12 added in the last 30 days.

Open-source alternatives to Todo.txt-cli

See all

SaaS alternatives to Todo.txt-cli

See all