Tim Izzo @5ika.ch
todo.txt-go
todo.txt-go is a TUI program for todo.txt written in Go. It provides a minimalistic and efficient interface in the terminal to handle todo list following todo-txt format rules stored in a plain text file.
Installation
Ensure that you have a supported version of Go properly installed and setup.
You can then install the latest release globally by running:
git clone https://5ika.ch/todo.txt-go.git
cd todo-txt
go install
todo-txt
is now available in your terminal.
Configuration
Tasks are stored in a todo.txt
file in the TODO_DIR
directory.
By default, the TODO_DIR
is $HOME/.todo
but you can change it
with two ways:
By setting
TODO_DIR
environment variableexport TODO_DIR=~/tasks todo-txt
By using
-dir
flagtodo-txt -dir ~/tasks
Use
Keymaps
Up
orDown
: Move cursorShift+Up
orShift+Down
: Move focused taskA
or+
: Add a new taskEnter
: Edit focused taskSpace
: Check/Uncheck focused taska
,b
,c
,d
: Set priority level for focused taskz
: Clear priority of focused taskp
: Sort task by prioritys
: Sort task by dateu
: Clear done tasks (move them to done.txt)q
: Quit
Due date
Additionnaly, it handles due dates as a custom key:value metadata. Example:
(B) Review pull request #123 @work +code due:2025-09-05
Clear tasks history
Done tasks are archived to done.txt file when u
is entered.
Contribution
Intrested by this project ? Contact me
Code is available here: https://git.5ika.ch/todo.txt-go.git