~ariadnavigo/cras

The Anti-Procrastination Tool
4 months ago

6fb093c cras 2.2.4

4 months ago

#cras - The Anti-Procrastination Tool

cras is an unapologetic task list manager for your terminal and WM status bar, but with a catch: Task lists are accessible only for a limited amount of time set by the user!

#Basic usage

cras creates a new task list using the -n option and a file name. Calling cras without any options will show the contents of the task list file. The -t option followed by the task's number will mark it as done!

$ cras -n tasks
Enter to next entry; Ctrl-D saves; Ctrl-C aborts.
#01: Write this new task list
#02: Another important thing to do
#03: Don't forget this one either
#04: To finish, Ctrl+D
#05:
Task list saved.
$ cras tasks
2022-06-22
Enter to next entry; Ctrl-D saves; Ctrl-C aborts.
#01 [TODO] Write this new task list
#02 [TODO] Another important thing to do
#03 [TODO] Don't forget this one either
#04 [TODO] To finish, Ctrl+D
$ cras -t 3 tasks
#03 [DONE] Don't forget this one either

You may check the cras(1) manpage for further usage information.

#Build

cras is supported on Linux and OpenBSD, and requires:

  1. A C17 compiler
  2. sline 3.0+
  3. scdoc: to generate the manpage.

Build by using:

$ make

Customize the build process by changing config.mk to suit your needs.

User configuration is performed by modifying config.h. A set of defaults is provided in config.def.h.

#Install

You may install cras by running the following command as root:

# make install

This will install the binary under $PREFIX/bin, as defined by your environment, or /usr/local/bin by default. The Makefile supports the $DESTDIR variable as well.

#Contributing

You're very welcome to contribute with patches and discussion by sending an email to ~ariadnavigo/cras-devel@lists.sr.ht. You may want to check out the cras tracker to see where the work is being done right now.

You may stay up-to-date for news about the project by subscribing to the ~ariadnavigo/cras-announce@lists.sr.ht mailing list as well.

#Cultural trivia

cras means 'tomorrow' in Latin. For instance, the English word procrastination means, literally, 'the act of postponing things for tomorrow.'

#License

cras is published under the MIT License. See LICENSE file for copyright and license details.