td-task 0.1.5__tar.gz → 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
td_task-0.2.0/.env.enc ADDED
Binary file
@@ -0,0 +1,33 @@
1
+ name: Publish to PyPI
2
+
3
+ on:
4
+ workflow_dispatch:
5
+ push:
6
+ tags:
7
+ - 'v*'
8
+
9
+ jobs:
10
+ deploy:
11
+ runs-on: ubuntu-latest
12
+ steps:
13
+ - name: Checkout code
14
+ uses: actions/checkout@v4
15
+
16
+ - name: Install uv
17
+ uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
18
+
19
+ - name: Install Doppler CLI
20
+ uses: dopplerhq/cli-action@v3
21
+
22
+ - name: Set up Python
23
+ uses: actions/setup-python@v5
24
+ with:
25
+ python-version: '3.14'
26
+
27
+ - name: Build package
28
+ run: uv build
29
+
30
+ - name: Publish to PyPI
31
+ run: doppler run -- sh -c 'UV_PUBLISH_TOKEN="$PYPI_API" uv publish'
32
+ env:
33
+ DOPPLER_TOKEN: ${{ secrets.DOPPLER_TOKEN }}
@@ -5,3 +5,4 @@ __pycache__/
5
5
  .venv/
6
6
  .env
7
7
  AGENTS.md
8
+ CLAUDE.md
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: td-task
3
- Version: 0.1.5
4
- Summary: Minimal TUI todo app
3
+ Version: 0.2.0
4
+ Summary: Fast TUI and CLI manager for tasks and Markdown notes
5
5
  Requires-Python: >=3.14
6
6
  Requires-Dist: cryptography>=42.0.0
7
7
  Requires-Dist: rich>=15.0.0
@@ -11,7 +11,8 @@ Description-Content-Type: text/markdown
11
11
 
12
12
  # td
13
13
 
14
- A fast, keyboard-driven TUI todo manager for the terminal. Multi-list, encrypted, scriptable.
14
+ A fast, keyboard-driven terminal manager for tasks and Markdown notes. Multi-list,
15
+ encrypted, scriptable, and built for humans and agents.
15
16
 
16
17
  ![td demo](assets/demo.gif)
17
18
 
@@ -50,6 +51,7 @@ td [command] [--list <name>]
50
51
  | `td` | Open the TUI (defaults to first list) |
51
52
  | `td add <text>` | Add a task to a list |
52
53
  | `td list` | Print active tasks to stdout |
54
+ | `td notes …` | Create, inspect, update, list, and delete Markdown notes |
53
55
  | `td archive` | Open the archive screen |
54
56
  | `td export [file]` | Export database to JSON (stdout if no file) |
55
57
  | `td import <file>` | Merge a JSON backup into the database |
@@ -66,6 +68,35 @@ td list --list work
66
68
  td export backup.json
67
69
  ```
68
70
 
71
+ ### Notes CLI
72
+
73
+ Notes use the same lists, ordering, completion state, archives, and encryption as
74
+ tasks. Every command supports stable note IDs. Add `--json` for structured output.
75
+
76
+ ```bash
77
+ # create with inline Markdown
78
+ td notes add "Release plan" -l work --body $'# Release\n* test\n* ship' --json
79
+
80
+ # create from a file or stdin
81
+ td notes add "Runbook" -l ops --body-file runbook.md
82
+ cat incident.md | td notes add "Incident" -l ops --body-file -
83
+
84
+ # discover and read notes
85
+ td notes list -l work --json
86
+ td notes show 12
87
+ td notes show 12 --json
88
+
89
+ # update title or body
90
+ td notes update 12 --title "Final release plan"
91
+ td notes update 12 --body-file plan.md --json
92
+
93
+ # delete note and its task-backed list item
94
+ td notes delete 12 --json
95
+ ```
96
+
97
+ `td notes add` uses the current timestamp when you omit the title. Pass
98
+ `--include-archived` to `td notes list` when agents need archived notes too.
99
+
69
100
  ## TUI Keybindings
70
101
 
71
102
  ### Tasks
@@ -73,7 +104,9 @@ td export backup.json
73
104
  | Key | Action |
74
105
  |-----|--------|
75
106
  | `a` | Add new task |
76
- | `e` / `Enter` | Edit selected task |
107
+ | `A` | Add a task-backed Markdown note |
108
+ | `e` / `Enter` | Edit selected task or open selected note |
109
+ | `E` | Rename selected note |
77
110
  | `d` | Delete selected task |
78
111
  | `Space` | Toggle done / active |
79
112
  | `s` | Star task (pin to top, bold yellow) |
@@ -90,6 +123,25 @@ td export backup.json
90
123
  | `?` | Help screen |
91
124
  | `q` / `Esc` | Quit |
92
125
 
126
+ ### Note Editor
127
+
128
+ | Key | Action |
129
+ |-----|--------|
130
+ | `Esc` | Save and close |
131
+ | `Ctrl+S` | Save without closing |
132
+ | `Enter` | Insert a new line |
133
+ | `Alt+↑` / `Alt+↓` | Move current line up or down |
134
+ | `Cmd+Backspace` on macOS / `Ctrl+Backspace` elsewhere | Clear current line |
135
+ | `Tab` / `Shift+Tab` | Indent or outdent current line |
136
+ | Arrow keys / `Home` / `End` | Move cursor |
137
+ | `Backspace` / `Delete` | Delete text or join lines |
138
+
139
+ The active line shows raw Markdown. Other lines show a live preview. The editor
140
+ supports `#` headings, `*` bullets, `*bold*`, `**bold**`, and `_italic_` text.
141
+ `Alt+Left` / `Alt+Right` moves by word. `Alt+Backspace` deletes one word.
142
+ After a root bullet, `Enter` starts an indented continuation and keeps its bullet
143
+ marker. Press `Enter` or `Backspace` on an empty continuation to leave list mode.
144
+
93
145
  ### Lists Menu
94
146
 
95
147
  | Key | Action |
@@ -97,11 +149,22 @@ td export backup.json
97
149
  | `Enter` | Switch to highlighted list |
98
150
  | `a` | Create new list |
99
151
  | `e` | Rename list |
152
+ | `A` | Archive list while preserving its items |
153
+ | `,` | Open archived lists |
100
154
  | `d` | Delete list (with all its tasks) |
101
155
  | `Shift+↑` / `Shift+↓` | Reorder list position |
102
156
  | `↑` / `k` &nbsp; `↓` / `j` | Navigate lists |
103
157
  | `q` / `Esc` | Quit |
104
158
 
159
+ ### Archived Lists
160
+
161
+ | Key | Action |
162
+ |-----|--------|
163
+ | `Enter` / `r` | Restore highlighted list |
164
+ | `d` | Permanently delete highlighted list and its items |
165
+ | `↑` / `k` &nbsp; `↓` / `j` | Navigate archived lists |
166
+ | `q` / `Esc` | Return to active lists |
167
+
105
168
  ### Archive
106
169
 
107
170
  | Key | Action |
@@ -121,7 +184,8 @@ td export backup.json
121
184
  | `↑` / `k` &nbsp; `↓` / `j` | Navigate settings |
122
185
  | `q` / `Esc` | Return |
123
186
 
124
- Settings you can change: max tasks per list (3–50), max starred tasks, database encryption (AES), and backup export / import.
187
+ Settings you can change: max tasks per list (3–50), max starred tasks, whole-database
188
+ encryption, current-list encryption, and backup export / import.
125
189
 
126
190
  ## Agent-friendly
127
191
 
@@ -135,6 +199,11 @@ td add "update dependencies" -l work
135
199
  # read tasks as plain text
136
200
  td list -l work
137
201
 
202
+ # create and query Markdown notes as JSON
203
+ td notes add "PR review" -l work --body "# Findings" --json
204
+ td notes list -l work --json
205
+ td notes show 1 --json
206
+
138
207
  # dump the full database as JSON
139
208
  td export | jq '.tasks[] | select(.status == "active")'
140
209
 
@@ -144,6 +213,14 @@ TD_DB_PATH=/tmp/agent.db td add "isolated task" -l inbox
144
213
 
145
214
  The `--help` output is written to be LLM-readable, so agents can self-orient by running `td --help`.
146
215
 
216
+ ## Stack
217
+
218
+ - **Python 3.14+** — application and CLI runtime.
219
+ - **SQLite** — single-file storage for lists, tasks, notes, settings, and encryption metadata.
220
+ - **Rich + raw ANSI terminal I/O** — styled rendering and keyboard input without a TUI framework.
221
+ - **Cryptography** — Fernet encryption with PBKDF2-derived database or per-list keys.
222
+ - **uv + Hatchling** — dependency management, builds, and Python packaging.
223
+
147
224
  ## Architecture
148
225
 
149
226
  `td` is a single Python package with no framework dependencies:
@@ -163,13 +240,22 @@ Works on macOS, Linux, and Windows. On Windows, use a terminal with ANSI support
163
240
 
164
241
  ## Data model
165
242
 
166
- Two tables in a SQLite file:
243
+ Four core tables in a SQLite file:
167
244
 
168
- **`lists`** — `name` (PK), `position`, `max_tasks`
245
+ **`lists`** — `name` (PK), `position`, `max_tasks`, `archived_at`
169
246
 
170
247
  **`tasks`** — `id`, `text`, `status` (`active` / `done` / `archived`), `position`, `created_at`, `done_at`, `archived_at`, `starred`, `list_name` (FK → lists, CASCADE DELETE)
171
248
 
172
- Tasks keep their timestamps through the full lifecycle: created → done → archived. Deleting a list permanently removes all its tasks via the cascade.
249
+ **`notes`** — `id`, `task_id` (unique FK → tasks, CASCADE DELETE), `title`, `content`, `created_at`, `updated_at`
250
+
251
+ **`list_encryption`** — `list_name` (PK/FK → lists), `encryption_salt`, `password_verifier`
252
+
253
+ Each note attaches to a task. It therefore shares task ordering, completion,
254
+ starring, archiving, and list membership. Note names appear underlined in lists.
255
+ Deleting a task or list also deletes attached notes through cascades.
256
+
257
+ Archived lists keep all tasks and notes. They disappear from normal navigation
258
+ until restored from the Lists Menu.
173
259
 
174
260
  ## Portability
175
261
 
@@ -186,8 +272,7 @@ td export > backup.json
186
272
  td import backup.json
187
273
  ```
188
274
 
189
- You can encrypt the database with a password from the settings screen (`/`). If you forget the password, there is no recovery — your tasks are gone.
190
-
191
- ## Show some love
192
-
193
- Ethereum: `0x88a0e1b80B92F0cFaa89a936b827Ce291cFb0028`
275
+ You can encrypt the whole database or only the current list from settings (`/`).
276
+ Each encrypted list uses its own password-derived key. Tasks and note bodies stay
277
+ encrypted in JSON backups. Whole-database and per-list encryption cannot run
278
+ together. If you forget a password, there is no recovery.
@@ -1,6 +1,7 @@
1
1
  # td
2
2
 
3
- A fast, keyboard-driven TUI todo manager for the terminal. Multi-list, encrypted, scriptable.
3
+ A fast, keyboard-driven terminal manager for tasks and Markdown notes. Multi-list,
4
+ encrypted, scriptable, and built for humans and agents.
4
5
 
5
6
  ![td demo](assets/demo.gif)
6
7
 
@@ -39,6 +40,7 @@ td [command] [--list <name>]
39
40
  | `td` | Open the TUI (defaults to first list) |
40
41
  | `td add <text>` | Add a task to a list |
41
42
  | `td list` | Print active tasks to stdout |
43
+ | `td notes …` | Create, inspect, update, list, and delete Markdown notes |
42
44
  | `td archive` | Open the archive screen |
43
45
  | `td export [file]` | Export database to JSON (stdout if no file) |
44
46
  | `td import <file>` | Merge a JSON backup into the database |
@@ -55,6 +57,35 @@ td list --list work
55
57
  td export backup.json
56
58
  ```
57
59
 
60
+ ### Notes CLI
61
+
62
+ Notes use the same lists, ordering, completion state, archives, and encryption as
63
+ tasks. Every command supports stable note IDs. Add `--json` for structured output.
64
+
65
+ ```bash
66
+ # create with inline Markdown
67
+ td notes add "Release plan" -l work --body $'# Release\n* test\n* ship' --json
68
+
69
+ # create from a file or stdin
70
+ td notes add "Runbook" -l ops --body-file runbook.md
71
+ cat incident.md | td notes add "Incident" -l ops --body-file -
72
+
73
+ # discover and read notes
74
+ td notes list -l work --json
75
+ td notes show 12
76
+ td notes show 12 --json
77
+
78
+ # update title or body
79
+ td notes update 12 --title "Final release plan"
80
+ td notes update 12 --body-file plan.md --json
81
+
82
+ # delete note and its task-backed list item
83
+ td notes delete 12 --json
84
+ ```
85
+
86
+ `td notes add` uses the current timestamp when you omit the title. Pass
87
+ `--include-archived` to `td notes list` when agents need archived notes too.
88
+
58
89
  ## TUI Keybindings
59
90
 
60
91
  ### Tasks
@@ -62,7 +93,9 @@ td export backup.json
62
93
  | Key | Action |
63
94
  |-----|--------|
64
95
  | `a` | Add new task |
65
- | `e` / `Enter` | Edit selected task |
96
+ | `A` | Add a task-backed Markdown note |
97
+ | `e` / `Enter` | Edit selected task or open selected note |
98
+ | `E` | Rename selected note |
66
99
  | `d` | Delete selected task |
67
100
  | `Space` | Toggle done / active |
68
101
  | `s` | Star task (pin to top, bold yellow) |
@@ -79,6 +112,25 @@ td export backup.json
79
112
  | `?` | Help screen |
80
113
  | `q` / `Esc` | Quit |
81
114
 
115
+ ### Note Editor
116
+
117
+ | Key | Action |
118
+ |-----|--------|
119
+ | `Esc` | Save and close |
120
+ | `Ctrl+S` | Save without closing |
121
+ | `Enter` | Insert a new line |
122
+ | `Alt+↑` / `Alt+↓` | Move current line up or down |
123
+ | `Cmd+Backspace` on macOS / `Ctrl+Backspace` elsewhere | Clear current line |
124
+ | `Tab` / `Shift+Tab` | Indent or outdent current line |
125
+ | Arrow keys / `Home` / `End` | Move cursor |
126
+ | `Backspace` / `Delete` | Delete text or join lines |
127
+
128
+ The active line shows raw Markdown. Other lines show a live preview. The editor
129
+ supports `#` headings, `*` bullets, `*bold*`, `**bold**`, and `_italic_` text.
130
+ `Alt+Left` / `Alt+Right` moves by word. `Alt+Backspace` deletes one word.
131
+ After a root bullet, `Enter` starts an indented continuation and keeps its bullet
132
+ marker. Press `Enter` or `Backspace` on an empty continuation to leave list mode.
133
+
82
134
  ### Lists Menu
83
135
 
84
136
  | Key | Action |
@@ -86,11 +138,22 @@ td export backup.json
86
138
  | `Enter` | Switch to highlighted list |
87
139
  | `a` | Create new list |
88
140
  | `e` | Rename list |
141
+ | `A` | Archive list while preserving its items |
142
+ | `,` | Open archived lists |
89
143
  | `d` | Delete list (with all its tasks) |
90
144
  | `Shift+↑` / `Shift+↓` | Reorder list position |
91
145
  | `↑` / `k` &nbsp; `↓` / `j` | Navigate lists |
92
146
  | `q` / `Esc` | Quit |
93
147
 
148
+ ### Archived Lists
149
+
150
+ | Key | Action |
151
+ |-----|--------|
152
+ | `Enter` / `r` | Restore highlighted list |
153
+ | `d` | Permanently delete highlighted list and its items |
154
+ | `↑` / `k` &nbsp; `↓` / `j` | Navigate archived lists |
155
+ | `q` / `Esc` | Return to active lists |
156
+
94
157
  ### Archive
95
158
 
96
159
  | Key | Action |
@@ -110,7 +173,8 @@ td export backup.json
110
173
  | `↑` / `k` &nbsp; `↓` / `j` | Navigate settings |
111
174
  | `q` / `Esc` | Return |
112
175
 
113
- Settings you can change: max tasks per list (3–50), max starred tasks, database encryption (AES), and backup export / import.
176
+ Settings you can change: max tasks per list (3–50), max starred tasks, whole-database
177
+ encryption, current-list encryption, and backup export / import.
114
178
 
115
179
  ## Agent-friendly
116
180
 
@@ -124,6 +188,11 @@ td add "update dependencies" -l work
124
188
  # read tasks as plain text
125
189
  td list -l work
126
190
 
191
+ # create and query Markdown notes as JSON
192
+ td notes add "PR review" -l work --body "# Findings" --json
193
+ td notes list -l work --json
194
+ td notes show 1 --json
195
+
127
196
  # dump the full database as JSON
128
197
  td export | jq '.tasks[] | select(.status == "active")'
129
198
 
@@ -133,6 +202,14 @@ TD_DB_PATH=/tmp/agent.db td add "isolated task" -l inbox
133
202
 
134
203
  The `--help` output is written to be LLM-readable, so agents can self-orient by running `td --help`.
135
204
 
205
+ ## Stack
206
+
207
+ - **Python 3.14+** — application and CLI runtime.
208
+ - **SQLite** — single-file storage for lists, tasks, notes, settings, and encryption metadata.
209
+ - **Rich + raw ANSI terminal I/O** — styled rendering and keyboard input without a TUI framework.
210
+ - **Cryptography** — Fernet encryption with PBKDF2-derived database or per-list keys.
211
+ - **uv + Hatchling** — dependency management, builds, and Python packaging.
212
+
136
213
  ## Architecture
137
214
 
138
215
  `td` is a single Python package with no framework dependencies:
@@ -152,13 +229,22 @@ Works on macOS, Linux, and Windows. On Windows, use a terminal with ANSI support
152
229
 
153
230
  ## Data model
154
231
 
155
- Two tables in a SQLite file:
232
+ Four core tables in a SQLite file:
156
233
 
157
- **`lists`** — `name` (PK), `position`, `max_tasks`
234
+ **`lists`** — `name` (PK), `position`, `max_tasks`, `archived_at`
158
235
 
159
236
  **`tasks`** — `id`, `text`, `status` (`active` / `done` / `archived`), `position`, `created_at`, `done_at`, `archived_at`, `starred`, `list_name` (FK → lists, CASCADE DELETE)
160
237
 
161
- Tasks keep their timestamps through the full lifecycle: created → done → archived. Deleting a list permanently removes all its tasks via the cascade.
238
+ **`notes`** — `id`, `task_id` (unique FK → tasks, CASCADE DELETE), `title`, `content`, `created_at`, `updated_at`
239
+
240
+ **`list_encryption`** — `list_name` (PK/FK → lists), `encryption_salt`, `password_verifier`
241
+
242
+ Each note attaches to a task. It therefore shares task ordering, completion,
243
+ starring, archiving, and list membership. Note names appear underlined in lists.
244
+ Deleting a task or list also deletes attached notes through cascades.
245
+
246
+ Archived lists keep all tasks and notes. They disappear from normal navigation
247
+ until restored from the Lists Menu.
162
248
 
163
249
  ## Portability
164
250
 
@@ -175,8 +261,7 @@ td export > backup.json
175
261
  td import backup.json
176
262
  ```
177
263
 
178
- You can encrypt the database with a password from the settings screen (`/`). If you forget the password, there is no recovery — your tasks are gone.
179
-
180
- ## Show some love
181
-
182
- Ethereum: `0x88a0e1b80B92F0cFaa89a936b827Ce291cFb0028`
264
+ You can encrypt the whole database or only the current list from settings (`/`).
265
+ Each encrypted list uses its own password-derived key. Tasks and note bodies stay
266
+ encrypted in JSON backups. Whole-database and per-list encryption cannot run
267
+ together. If you forget a password, there is no recovery.
Binary file
@@ -11,13 +11,13 @@ Set PlaybackSpeed 0.85
11
11
 
12
12
  # Warm up, set env, clear before Show
13
13
  Hide
14
- Type "cd /Users/lucaspon/repos/td-tasks && export TD_DB_PATH=/tmp/td_demo.db && rm -f $TD_DB_PATH && uv -q run td --version > /dev/null 2>&1 && clear"
14
+ Type "export TD_DB_PATH=/tmp/td_demo.db && rm -f $TD_DB_PATH && td --version > /dev/null 2>&1 && clear"
15
15
  Enter
16
16
  Sleep 3s
17
17
  Show
18
18
 
19
19
  # Launch the TUI — env var already set in Hide
20
- Type "uv -q run td -l work"
20
+ Type "td -l work"
21
21
  Enter
22
22
  Sleep 1400ms
23
23
 
@@ -1,7 +1,7 @@
1
1
  [project]
2
2
  name = "td-task"
3
- version = "0.1.5"
4
- description = "Minimal TUI todo app"
3
+ version = "0.2.0"
4
+ description = "Fast TUI and CLI manager for tasks and Markdown notes"
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.14"
7
7
  dependencies = [
@@ -1,5 +1,15 @@
1
1
  # Changelog
2
2
 
3
+ ## [0.2.0] - 2026-08-03
4
+ - Add task-backed Markdown notes with a full-screen editor and live line preview.
5
+ - Add `A` to create notes, `e`/`Enter` to edit note bodies, and `E` to rename notes.
6
+ - Include notes in encryption, JSON backup and restore, list ordering, and task lifecycle actions.
7
+ - Add line movement, line clearing, word navigation, word deletion, and indentation controls to the note editor.
8
+ - Add restorable list archiving with preserved tasks, notes, settings, and JSON backup state.
9
+ - Auto-indent and continue Markdown bullets; exit empty continuation with Enter or Backspace.
10
+ - Add independent password encryption per list with portable encrypted backups and lazy unlock prompts.
11
+ - Add agent-friendly notes CLI with CRUD actions, JSON output, and file or stdin bodies.
12
+
3
13
  ## [0.1.5]
4
14
  - Fix Windows keyboard input: arrow keys, Home/End, Delete, and Ctrl/Alt+arrow now work by decoding the native Windows scancode protocol instead of assuming ANSI escape sequences.
5
15
  - Fix clipboard copy (`y`) on Windows by using the `clip` command.