README
¶
todogo
A terminal UI todo manager written in Go, following the todo.txt format.
Install
Requires Go 1.24+.
make install # install to $GOPATH/bin
make build # build binary → ./todogo
Usage
todogo
No subcommands — todogo opens the TUI directly. Press ? for the full keybinding reference.
Configuration
Config file ~/.config/todogo/todogo.toml is created automatically on first run:
todo_file = "~/todo.txt"
accent_color = "#cba6f7"
| Field | Description | Default |
|---|---|---|
todo_file |
Path to your todo.txt file |
~/todo.txt |
accent_color |
Hex colour for highlights and borders | #cba6f7 (Catppuccin Mauve) |
todo.txt format
(A) 2025-01-15 Buy milk +Groceries @Store due:2025-01-20
x 2025-03-11 2025-01-15 Buy milk +Groceries @Store
| Token | Description |
|---|---|
x |
Done (must be followed by a space) |
(A) |
Priority — single uppercase letter |
2025-01-15 |
Creation date (or completion date when preceded by x) |
+Project |
Project tag |
@Context |
Context tag |
due:2025-01-20 |
Due date |
pri:A |
Saved priority — written on completion so it can be restored |
See the todo.txt spec for the full format.
Development
make build # build binary → ./todogo
make run # build and run
make test # run tests
make clean # remove binary
make install # install to $GOPATH/bin
Stack: Bubble Tea · Lip Gloss · Bubbles · BurntSushi/toml
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package todo implements parsing, serialisation, and file I/O for the todo.txt format (https://github.com/todotxt/todo.txt).
|
Package todo implements parsing, serialisation, and file I/O for the todo.txt format (https://github.com/todotxt/todo.txt). |
Click to show internal directories.
Click to hide internal directories.