Home - mkaito/habitcli GitHub Wiki

HabitCLI is a unix console client for HabitRPG.

HabitRPG is an open source habit building program which treats your life like a Role Playing Game. Level up as you succeed, lose HP as you fail, earn money to buy weapons and armor.

There are three components to the project:

  • A library wrapping the HabitRPG API.
  • A batch-mode meant for script usage.
  • An ncurses-based full-screen interface.

The API is documented here.

Users will need to place their user id and API token in a config file.

Feature ideas

  • Run in the background as a daemon. Daemon can sync updates, provide notifications, and speed things up a little for the clients. Clients should be able to run without the daemon as well.

  • Daemon could check foreground application at intervals and toggle habits based on whether you're being nice or naughty.

  • Integrate the batch interface with your favourite Pomodoro timer to give you habit-ups for being productive.

  • Use the batch mode to query your stats for conky.