hrn

Crates.iohrn
lib.rshrn
version0.1.0
created_at2025-07-01 14:06:47.168136+00
updated_at2025-07-01 14:06:47.168136+00
descriptionManage plans (lists) and notes
homepagehttps://sr.ht/~bitfehler/hrn
repositoryhttps://git.sr.ht/~bitfehler/hrn
max_upload_size
id1733252
size158,880
Conrad Hoffmann (bitfehler)

documentation

README

hrn

Yet another take on notes, plans (to-do lists), and even mind maps. But this one is taylored specifically to my needs, so it is obviously the correct one.

What is it?

hrn's primary use case is editing plan files:

∙ This is my plan for the week
  ∙ some TODO
  … task in progress
    ✓ this is done
    ∙ another subtask
  𐄂 gave up on this

hrn provides a terminal user interface that makes editing such files extremely convenient. But it also adds some twists:

  • such lists are trees, and so are directories of files - hrn lets you open a directory to edit multiple plan files in a single tree
  • sometimes, you need more than a few words to keep track of something - every item can be linked to a notes file, which can be conveniently shown or edited with your favorite pager or editor
  • focus is key - the view can be reduced to a subtree, to not get distracted by other tasks, or simply reclaim screen estate for what matters right now
  • finding the right tasks to do can be half the work - the view mode can be switched to a h-m-m-inspired "mind map style" to help organize your thoughts

What it isn't

  • a zettelkasten - hrn's focus is on the plan files, and links are only from plan items to notes, not vice versa, not between notes, and not between items
  • a search engine - hrn never "reads" the notes files, so it also doesn't search them

Getting started

Basic usage along with the key bindings are described in the man page. The bindings are currently not configurable.

To get started, best start editing a single file:

hrn todo.plan

Contact

Feel free to send questions, patches, or other feedback to my public inbox.

Commit count: 0

cargo fmt