nin

A simple, full-featured command line todo app 

Features

• Simple, easy-to-use CLI
• Currently supports: listing, adding, editing, deleting, completing, archiving, and deleting archived todo items
• Smart colored output
• Uses YAML for storage by default (There's an option to use TOML but no configuration for it, yet)
• Modular code covered by unit tests

Installation

gem install nin

To run the tests:

rake

Usage

NAME:
        nin - a simple, full-featured command line todo app

USAGE:
        nin COMMAND [arguments...]

COMMANDS:
        l  | list          [a]        List all unarchived todos. Pass optional argument `a` to list all todos
        a  | add           desc       Add a todo. Prepend due date by a @. Prepend each tag by a \#
        e  | edit          id desc    Edit a todo. Prepend due date by a @. Prepend each tag by a \#
        p  | prioritize    id step    Prioritize a todo by either a positive or negative step within its date group
        c  | complete      id(s)      Un/complete todo(s)
        ac | archive       id(s)      Un/archive todo(s)
        d  | delete        id(s)      Delete todo(s)
        gc | garbage                  Delete all archived todos. Resets item ids as a side effect
        s  | analyze                  Analyze tasks and print statistics
        i  | repl                     Open nin in REPL mode
        o  | open                     Open todo file in $EDITOR

Why

Why write another todo app? I like to use the terminal for everything and I've been using a markdown file to manage my todo list. I looked for something simple and I found Todo.rb which nin started as a spinoff from. However, I needed to add some more features. I then found Todolist which I took some inspiration from but kept the CLI as simple as it is in Todo.rb. I also didn't like that todolist uses JSON to store the todo items because I wanted to view the file on my phone and I needed something more readable.

Contribution

Contributions are welcome. If you found a bug or want to add a new feature, open an issue or send a pull request.

License

See LICENSE.