Home

Awesome

cations

cations_screenshot

Ready to make productivity a habit?

cations is a lightweight application that helps you build and maintain good habits through incremental progress. Using this application, you can apply the philosophy of leading productivity systems, such as James Clear's "Atomic Habits", to achieve significant long-term success in a manageable and realistic way.

cations is designed to run entirely in the terminal, allowing you to use it easily and conveniently. User-friendliness and efficiency are prioritized, so you can focus on completing your habits.

Quick Start

Follow these steps to install cations and get started right away.

Note: This application requires Python 3 and pip3 to be installed on your system.

  1. Not necessary, but recommended: Navigate to your home directory (or whichever directory you normally clone repositories to) first.
cd ~
  1. Clone the repository:
git clone https://github.com/Alcryst/cations.git
  1. Enter the project directory:
cd cations
  1. Run the setup file:
sh install.sh

NOTE: the above command may not work for users of certain Linux distributions including Manjaro. If you are experiencing this issue, please try the manual fix here.

  1. Once installation has completed, you will be able to start the application by simply entering the command:
cations

NOTE: if at this point you get an error saying that the command does not exist, please make sure your Python scripts are added to your $PATH variable. An easy fix is to install the most recent version of Python 3, as the modern official installer will automatically configure your $PATH variable for you.

Usage

Each habit is represented by an "ion". When creating your ion, name it after a habit you want to repeat each day - for example, "Practice the piano" or "Write a line of code". Make it simple and easy to complete, to inspire you to get started and make consistent progress; once you've achieved consistency then you can slowly start to increase the intensity of your habit (and change the name of your ion if you wish).

You can complete each ion every day to extend your streak: the number of consecutive days that you've completed an ion. If you miss a day, your streak will reset to 0. Don't be demotivated, though; the important part is getting back on track.

Press C for full controls on how to use the application.

Uninstallation/Deletion Instructions

  1. You can uninstall everything except the repository files with pip3 like so:
pip3 uninstall cations
  1. To remove the rest of the files, navigate to the directory containing cations and manually remove the directory, e.g. through the file explorer or command line:
rm -vrf cations/

NOTE: be careful that you're using this command on the right directory if you choose to use it!

Uninstalling will delete your user data.

Update Instructions

Uninstall and do a fresh install as shown above. You will lose your previous user data; to save it, find the ions.txt file in your cloned cations repository at cations/cations_dir/user_data/ions.txt and copy the data. Then, upon reinstallation, paste the data into the newly created ions.txt file at the same location within the cations directory.

Patch Notes

Contributions & License

Contributions are more than welcome! Feel free to submit issues or pull requests if you have ideas for how to make cations even better.

This project is licensed under the MIT License. See the LICENSE file for more information.

cations by Alcryst