# todo

a little modal todo list that lives in my terminal.

## keys

```text
= movement
  h j k l        move (h/l caret in the item, j/k between items)
  w / b          next / previous word
  { / }          previous / next section
  gg / G         top / bottom
  3j, 2dd, ...   a count repeats the next motion or operator

= editing
  o              add a new item below
  i              insert at the cursor
  A              append to the item's text
  R              replace mode (overtype from the cursor)
  x              toggle done
  space          cycle todo -> doing -> done
  dd             cut the item
  D              clear every done item
  yy p P         yank, paste below, paste above
  J / K          move the item down / up (on a heading, moves the whole section)

= other
  / n N          search, next match, previous match
  u  ctrl-r      undo, redo
  :w :q :wq :x   write, quit, write and quit
  :reset         set every item back to todo
  :clear         remove every item
```

## items

```text
= project          a section        -> I. project
== phase one       a subsection     -> i. phase one
- write the docs   a subtask
* maybe later      an optional task -> ( )
buy milk           a plain task
```

within a section, items group as required, then optional, then done, with a blank line between the groups.

## build

```sh
$ sudo make install            # -> /usr/local/bin + man page
$ make install PREFIX=~/.local # or somewhere without sudo
```

it's one file, so if you don't want the makefile:

```sh
$ cc -O2 todo.c -o todo
```

## license

`todo` is licensed under the mit license. see [license](LICENSE) for more.