---

HyperFocus is a minimalist CLI daily tasks manager that helps you stay focused on your work by avoiding distractions.

📜 Philosophy

You won't anticipate more than your daily goal with HyperFocus. No tasks prepared for the next week or month. The workflow is designed around the idea that, on a daily basis, you will review each unfinished tasks from the past day and choose whether you want to add it to the daily tasks. You are then able to prepare all your tasks for the day and update them to follow your work. The intention is to avoid overwhelming yourself and focus only on what you have prepared to do, for you and only you.

🚀 Quickstart

Installation

The library pipx allows to install and run Python applications in isolated environments so it does not mess around with your local installed library versions by keeping your local machine clean even after an uninstallation.

pipx install hyperfocus

Test your installation:

hyf --version

Initialization

In order to work properly, HyperFocus needs to initialize a database and a configuration file. Both are generated into your home directory, unless you specified another location.

hyf init

Example Usage

Add a new task:

hyf add "Implement the new super feature"

Add a new task with details:

hyf add "Read the great article about Python" -d "https://python-article.com"

Follow your daily tasks:

hyf status

or:

hyf

Find more information about all the commands in the documentation: hyperfocus.readthedocs.io