https://github.com/norm/whatnext
Lightweight task manager using Markdown files
https://github.com/norm/whatnext
markdown task-manager todo-list
Last synced: 5 months ago
JSON representation
Lightweight task manager using Markdown files
- Host: GitHub
- URL: https://github.com/norm/whatnext
- Owner: norm
- License: mit
- Created: 2025-11-27T22:06:33.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-02-10T10:26:02.000Z (5 months ago)
- Last Synced: 2026-02-10T15:58:41.960Z (5 months ago)
- Topics: markdown, task-manager, todo-list
- Language: Python
- Homepage:
- Size: 256 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# What next?
I like to keep tasks in Markdown files. That way they can be interspersed
within instructions, serving as reminders, FIXMEs, and other todos.
All the features for enhancing your task lists are discussed in detail in
[the documentation](docs/index.md).
Document your tasks using an expanded version of the original
[GitHub task list notation][sn]:
```markdown
- [ ] open, this task is outstanding
- [/] in progress, this task is partially complete
- [X] complete, this task has been finished
- [#] cancelled, this task has been scratched
- [<] blocked, this task needs more input
- [ ] _an important task_
# **Make apple pie from scratch**
- [ ] invent the universe
# Things for later
- [ ] get NYE fireworks tickets @2025-12-31
- [ ] but in the end it doesn't even matter @after
```
Then install `whatnext`:
```bash
pip install whatnext
```
Now run it and it'll tell you what's next, sorting by priority and state:
```bash
(computer)% whatnext
README.md:
# What next? / HIGH
- [ ] a lot more important
README.md:
# What next? / MEDIUM
- [ ] a little more important
README.md:
# What next? / IMMINENT 6d
- [ ] get NYE fireworks tickets
README.md:
# What next?
- [/] in progress, this task is partially complete
- [ ] open, this task is outstanding
- [<] blocked, this task needs more input
```
Also provided, `next` to add tasks to files.
```bash
# by default, adds to $HOME/tasks.md
(computer)% next Add more features to whatnext
Updated tasks.md
```
[sn]: https://blog.github.com/2013-01-09-task-lists-in-gfm-issues-pulls-comments/