---
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.