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.

Document your tasks using an expanded version of the original GitHub task list notation:

- [ ] 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:

pip install whatnext

Now run it and it'll tell you what's next, sorting by priority and state:

(computer)% whatnext
README.md:
    # Make apple pie from scratch / HIGH
    - [ ] invent the universe

README.md:
    # What next? / MEDIUM
    - [ ] an important task

README.md:
    # Things for later / 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.

# by default, adds to $HOME/tasks.md
(computer)% next Add more features to whatnext
Updated tasks.md

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

whatnext-3.5.tar.gz (65.2 kB view details)

Uploaded Aug 16, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

whatnext-3.5-py3-none-any.whl (22.6 kB view details)

Uploaded Aug 16, 2026 Python 3

File details

Details for the file whatnext-3.5.tar.gz.

File metadata

Download URL: whatnext-3.5.tar.gz
Upload date: Aug 16, 2026
Size: 65.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for whatnext-3.5.tar.gz
Algorithm	Hash digest
SHA256	`0ffb41bad82f685f63779c9f252e95adf3ade7f88aebc4874ff51671051c8a41`
MD5	`f2977356ab8b411aa47fa8e8b7b71d13`
BLAKE2b-256	`08737cc9bb9cdf69a6af6b809c538313f420c394bd79f3eeae2ac46662df0c03`

See more details on using hashes here.

Provenance

The following attestation bundles were made for whatnext-3.5.tar.gz:

Publisher: publish.yml on norm/whatnext

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: whatnext-3.5.tar.gz
- Subject digest: 0ffb41bad82f685f63779c9f252e95adf3ade7f88aebc4874ff51671051c8a41
- Sigstore transparency entry: 2484567624
- Sigstore integration time: Aug 16, 2026
Source repository:
- Permalink: norm/whatnext@1315dc3bca2bf01207407eae99f29eda9f3898af
- Branch / Tag: refs/tags/v3.5
- Owner: https://github.com/norm
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@1315dc3bca2bf01207407eae99f29eda9f3898af
- Trigger Event: push