The workshop · Independent · 24 Oct 2026

todotxt/todo.txt-cli

☑️ A simple and extensible shell script for managing your todo.txt file.

← The workshop

In simple English

This tool helps you manage your task list from your command-line interface (a text-only window where you type commands). It reads and writes tasks to a single plain text file that you can open anywhere. Your tasks stay on your computer in a format you control completely. There are no hidden databases or online accounts required. You can add, finish, and search tasks using short text commands.

What it is

A shell script (a small program made of commands for your computer's terminal) that parses and updates tasks in a standard text file format. It gives you an easy way to manage your work without using a heavy app.

What it is good for

Solo builders who like to keep their task lists in plain text files that sync easily across machines using regular file sync tools.

Stars6.2k
LicenceGPL-3.0
Latestv2.14.0 (2026-09-01)checked 24 Oct 2026
Last code change2026-10-11
Written inShell
Setup effort
2 / 5
Payoff
4 / 5
Good
  • Stores everything in a plain text file you can read and edit anywhere.
  • Runs instantly with almost zero memory usage.
  • Extensible with custom scripts and colour settings.
Watch for
  • Requires comfort with the command line to use effectively.
  • No built-in graphical interface for day-to-day viewing.
  • Setup requires running terminal commands or a package manager.
Replaces

The built-in notes app or graphical to-do list applications.

Works well with

A plain text editor like Vim or Nano.

Also reviewed on Repo Radar
  • jj-vcs/jj32k stars

    A version control system that stores its history in Git repositories but handles changes and conflicts differently.

  • banga/git-split-diffs2.7k stars

    Side-by-side, syntax-highlighted file differences in a terminal.

  • WerWolv/ImHex55k stars

    A hex editor with its own small language for describing the layout of a binary file.

Install
brew install todo-txt
cp -n $(brew --prefix)/opt/todo-txt/todo.cfg ~/.todo.cfg

Independent: reviewed for Repo Radar outside the daily editions. Every independent repository

On Stack Radar: Productivity & Collaboration › Personal Productivity & Focus › To-do Lists.

Get the next edition in your inbox

A dozen repositories, opened and checked. The licence read, the last release dated, and the ones that did not make it named with the reason. It is the half most lists leave out.

No tracking pixels. One click to leave. The archive stays free either way.

We use your address to send the edition and nothing else. Confirm by email, leave in one click. How we handle it.