Push Todos with Duedates to Top Script

This software stopped working after late July 2025 when Habitica started enforcing x-client requirements.

Information about the API change can be found at Application Programming Interface.

Description

Moves active tasks with due dates to the top of the To Do's list (excluding To Do's with future due dates).

There are other useful Python scripts by the author at https://github.com/DrStrangepork/habitica-scripts.

Installation

Install Python and (if not already installed) pip. This script has been tested with Python 2.7 but should work with 3.x.
Clone the repo.

   git clone https://github.com/DrStrangepork/habitica-scripts.git

Install pip packages.

   pip install -r requirements.txt

Configure the following lines of the script with your Habitica User ID and API Token:

   USR = os.getenv('HAB_API_USER', "YOUR_USERID_HERE")
   KEY = os.getenv('HAB_API_TOKEN', "YOUR_KEY_HERE")

The variables USR and KEY map to your User ID and API Token, respectively. You can either set the environment variables HAB_API_USER and HAB_API_TOKEN to your User ID and API Token or change the strings "YOUR_USERID_HERE" and "YOUR_KEY_HERE" to your User ID and API Token.