tododo 0.1.2

A minimal terminal todo manager built with Rust and Ratatui
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138

# todo

A minimal terminal todo manager.

Designed for keyboard-driven workflows with a focus on simplicity and low overhead.

---

## Installation

Install from crates.io:

```bash
cargo install tododo
````

Run:

```bash
todo
```

---

## Demo

![Todo TUI demo](docs/vhs/readme.gif)

---

## Quick Start

```bash
todo
```

Inside TUI:

* `a` — create todo
* `space` — toggle completion
* `e` — edit note
* `q` — quit

---

## Features

* Create, update, and delete todos
* Mark todos as done / undone
* Priority levels
* Inline note editing
* Fully keyboard-driven interaction
* SQLite-based persistence (no external dependencies)
* CLI and TUI modes
* JSON import / export support

---

## Usage

### TUI Mode / CLI Mode

```bash
todo -l                    # list todos
todo add "title"           # add todo
todo add "title" -c note   # add with note
todo add "title" -p S      # add with priority

todo done 1                # mark as done
todo delete 1              # delete
todo comment 1 "note"      # update note

todo json                  # export JSON
cat file.json | todo -i    # import JSON
```

---

## Keybindings

### Navigation

| Key       | Description    |
| --------- | -------------- |
| `j` / `k` | Move selection |
| `↑` / `↓` | Move selection |
| `Enter`   | Enter / back   |

### Actions

| Key     | Description       |
| ------- | ----------------- |
| `a`     | Create todo       |
| `space` | Toggle completion |
| `p`     | Cycle priority    |
| `e`     | Edit note         |
| `d`     | Delete todo       |
| `y`     | Confirm delete    |
| `n`     | Cancel delete     |

### Editing

| Key      | Description   |
| -------- | ------------- |
| `Ctrl+s` | Save          |
| `Esc`    | Cancel / back |

### Exit

| Key      | Description |
| -------- | ----------- |
| `q`      | Quit        |
| `Ctrl+c` | Force quit  |

In delete confirmation, `q` cancels the modal.

---

## Data Storage

* Path: `.todo/todo.db`
* Database: SQLite

Completed todos older than 30 days are hidden by default.

---

## Limitations

* Local-only (no sync)
* No tagging or grouping
* No configuration system

---

## License

MIT