User:Csfore/Gentodo

This article is a stub. Please help out by expanding it - how to get started.

GitHub

Gentodo is a todo program designed for a Gentoo development workflow.

Installation

Warning
Gentodo is currently very much in a testing phase and might have breaking changes upon a stable release.

Emerge

Install Gentodo from the GURU repository:

root #emerge --ask app-misc/gentodo

Usage

Adding an item

To add an item to the todo list:

user $gentodo add -t Title -d Details

It is also possible to not have a description:

user $gentodo add -t Title

Listing entries

To list entries:

user $gentodo

To get item IDs (required for deletion):

user $gentodo -v

Deleting an item

First get the item ID and then:

user $gentodo del 123

Files

Storage

To find your todo.json file, go to ~/.local/share/gentodo/todo.json, an example of which looks like:

FILE ~/.local/share/gentodo/todo.json

{
   "1": {
      "title": "Something to do",
      "details": "Description of thing to do"
   }
}

Configuration

Gentodo will eventually store its config in ~/.config/gentodo/config.toml. For now, this is an example of a config file:

FILE ~/.config/gentodo/config.toml

[gentodo]
token = "insert random gibberish here"

Tips

A handy use for this program is to add it to the user's ~/.bashrc so every time they open a new terminal they will be reminded of upcoming tasks that they need to look at.

FILE ~/.bashrc

# Put your fun stuff here.

# TODO list
echo "===== TODO List ====="
echo ""
gentodo --brief