summaryrefslogtreecommitdiff
path: root/skills/todo/SKILL.md
blob: 8e9d815c1baa214b90cedf3c3ee720ef5618241b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
---
description: Track a per-session todo list when a task has several steps to add, check off, or remove.
---

Run the script next to this file to keep a todo list for the current session:

```sh
~/.config/hax/skills/todo/todo.py {list [ID...] | add TEXT | done [ID...] | remove [ID...]}
```

- `list` prints a truncated view of every item; `list ID...` prints just those fully.
- `add TEXT` appends an item.
- `done ID...` marks items done; `remove ID...` deletes them.
- Items have stable ids, shown in the output and never reused, so they stay valid across additions and removals. `add`/`done`/`remove` echo the last few items so you can confirm ids without a separate `list`.
- Bulk views truncate long text; `list ID...` and the per-item reports of `done`/`remove` show the full text. Stored text is always intact.
- Keep items short. Use this only for genuine multi-step work, not for a single action.