todoxt

todo.txt-go is a TUI written in Go and Bubble Tea to manage todo.txt file.

Install

Ensure that you have a supported version of Go properly installed and setup. You can find the minimum required version of Go in the go.mod file.

You can then install the latest release globally by running:

git clone https://5ika.ch/todoxt.git
cd todoxt
go install

todoxt is now available in your CLI.

Config

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 variable

export TODO_DIR=~/tasks
todoxt

• By using -dir flag

todoxt -dir ~/tasks

Keymaps

• A or +: Add a new task
• D or -: Remove focused task
• Enter: Edit focused task
• Space: Check/Uncheck focused task
• a, b, c, d: Set priority level for focused task
• z: Clear priority of focused task
• p: Sort task by priority
• s: Sort task by date
• u: Clear done tasks (move them to done.txt)
• ?: Show full help

Features

todoxt is a TUI to manage todo list with todo.txt format rules stored in a plain text file.

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

Reccurring task

todoxt handles reccuring task with flag freq. Example:

(C) Update servers freq:month due:2025-09-05

On check of this task, it will be duplicated with a new due date (2025-10-05). If it doesn’t have a due date or if due date is in the past, the next due date is calculated from today’s date.

Available frequency values are: - day, daily - week, weekly - month, monthly - quarter, quarterly - year, yearly

Clear tasks history

Done tasks are archived to done.txt file when u is entered.

Contribution

Intrested by this project ? Contact me

Ressources

• https://github.com/charmbracelet/bubbletea
• https://github.com/1set/todotxt/blob/master/task.go
• https://github.com/todotxt/todo.txt
• https://github.com/freitass/todo.txt-vim