Back to catalog
todo.txt
GPL-3.0todo.txt replaces cloud task managers like Todoist with an open plain-text CLI workflow, providing full data ownership and zero-overhead task tracking.
Open-source alternative to — compare it against:
Overview
Lifehacker founder Gina Trapani created todo.txt in 2006 to escape proprietary database silos and reduce task management to an open, human-readable text file. The accompanying shell script, todo.sh, gives the terminal full command over that file using standard Unix utilities like grep and sed. That architecture keeps task tracking decoupled from remote servers, cloud sync engines, and subscription fees.
Why todo.txt instead of Todoist
Todoist operates as a cloud-hosted service where tasks reside in a remote database accessed via proprietary apps. In contrast, todo.txt requires zero server infrastructure: every action is a single line in a local text file, structured with plain-text tokens for priorities, projects, and contexts. Where Todoist handles reminders, natural-language parsing, and shared boards through its web API, todo.txt executes strictly on local hardware.
From an operational perspective, the trade-off is infrastructure autonomy versus managed synchronization. Operating todo.txt incurs no background daemon overhead and consumes no persistent memory. Engineers can track task lists in Git, sync them across hosts with rsync or SSH, and inspect diffs with standard tools. However, replacing Todoist requires managing synchronization manually, because todo.txt provides no native sync engine, relay server, or conflict resolution when files change concurrently across devices.
What it does well
- Shell pipeline integration:
todo.shoutputs plain text, letting engineers pipe tasks intogrep,awk,fzf, and custom scripts to filter workflows or trigger automated jobs. - Negligible system footprint: Executes as a lightweight POSIX shell script with no background runtime or database daemon, eliminating memory consumption on servers.
- Future-proof text format: Tasks use standard conventions like
(A)for priority,+projectfor categories, and@contextfor environments, remaining editable in any editor. - Git version control: The entire ledger lives in a single flat file, allowing engineers to track additions and completions through Git commits and branch diffs.
- Clean archiving: The built-in archive action moves completed items prefixed with
xinto a separate file, keeping the active list compact while preserving history.