focus-blocks 0.2.7

Focus Blocks: Simple and elegant daily time management tool.

fob

A CLI program for implementing Focus Blocks in your daily life.

Intro

Focus Blocks is my take on time management inspired by Flow State, Pomodoro Technique, Timeboxing, and Deep Work. Please read the Introduction to Focus Blocks first to understand the motivation for the creation of this program.

fob is a simple CLI program that lets you plan your month, and then visualize & update your progress within the Focus Blocks time management framework.

It is written in Python with minimal dependencies and can be installed on Mac, Linux, and Windows.

Quick Start

First, install uv (directions here)

Then, clone this repository to the directory of your choice.

git clone https://github.com/tensorturtle/fob.git

You can try out fob without installing it by using uv run:

uv run fob help

If you want to be able to call fob directly from your terminal, install it to your system:

./install.sh

This will compile and install fob. Now you can run:

fob help

A Day in the Life

It's the beginning of a new month - let's set our goals.

It's a new day! Say good morning!

Check off the first block of the day:

Let's remind ourselves what the day ahead looks like:

Oops, we couldn't do block 3. Let's change that block to 'Buffer', which is exactly for unforeseen things like this.

Checking off the final block for the day. Great job.

Come back tomorrow and say good morning to repeat.

Features

Cloud Sync

Bring your own cloud.

fob runs on a single database file. You can store this database on Dropbox or your own cloud. Just pass the path to the --database option when running fob. For example:

fob --database /home/tensorturtle/Dropbox/my-fob.db help

For more convenience, you can export a FOB_DB_PATH variable in your shell. For example, add the following line to ~/.bashrc (for bash shell):

export FOB_DB_PATH="/home/tensorturtle/Dropbox/my-fob.db"
source ~/.bashrc

Development

Run app in debug mode:

uv run fob --debug

Use database at custom path:

uv run fob --database ~/Downloads/testing_fob.db

The so-called database is actually just a human-readable JSON file. To see its location:

uv run fob info

Testing

uvx pytest

This is an end-to-end test. It installs fob to a temporary directory using install.sh and runs commands against it. Github Actions is set up to run the same test upon pushing to main branch.

Publishing

Update version number in pyproject.toml and utils/utils.py

Build and publish package to PyPI:

rm -r dist/
uv build
uv publish --token $TOKEN

Wait a moment for PyPI database to be updated (maybe a minute) and run:

uvx --from focus-blocks@latest fob