habit-tracker-cli 0.1.2

A small cross-platform habit tracker CLI with a polished interactive shell.

habit-tracker-cli

habit_tracker_cli is a small cross-platform habit tracker for the terminal. It keeps the command-line workflow simple, stores data locally in SQLite, and includes a lightweight interactive shell for day-to-day use.

• PyPI: https://pypi.org/project/habit-tracker-cli/
• Repository: https://github.com/Luis696969/habit-tracker-cli
• Requires Python 3.12+

Public command:

habit-tracker

Features

• Add daily habits or habits scheduled on specific weekdays
• Mark habits as done for today
• Undo today's completion for a habit
• Delete a habit and its completion history
• Show habits due today
• Check the current streak for one habit
• Show a weekly report
• Use an interactive shell with help, manual pages, and tab completion
• Clear local app data safely with clear-data

Installation

Windows

Recommended: pipx from PowerShell or Windows Terminal. pipx keeps the app isolated and avoids cluttering the main Python environment.

pipx install habit-tracker-cli

Alternative with pip:

pip install habit-tracker-cli

Linux

Recommended: pipx.

pipx install habit-tracker-cli

Alternative with pip:

pip install habit-tracker-cli

Install from source

pipx install .

Development install from source

pip install -e .[dev]
python -m pytest

Usage

habit-tracker add "Read 20 min" --daily
habit-tracker add "Go to the gym" --days mon,wed,fri
habit-tracker list
habit-tracker today
habit-tracker done "Read 20 min"
habit-tracker undo "Read 20 min"
habit-tracker delete "Go to the gym"
habit-tracker streak "Read 20 min"
habit-tracker report
habit-tracker report --week

report and report --week are equivalent in the current version.

Interactive shell

Start it explicitly:

habit-tracker shell

Running habit-tracker with no subcommand also enters the shell.

Prompt:

habit>

Shell commands:

• add
• list
• today
• done
• undo
• delete
• streak
• report
• help
• man
• clear
• clear-data
• exit
• q

Data storage

The app uses platformdirs for predictable per-user storage.

Typical locations:

OS	Data location
Windows	%LOCALAPPDATA%\habit_tracker_cli\
Linux	$XDG_DATA_HOME/habit_tracker_cli/ or ~/.local/share/habit_tracker_cli/

Shell state and history live in the matching per-user state/config directories for the same app name.

Optional overrides:

HABIT_TRACKER_DB_PATH=/custom/path/habit_tracker.db
HABIT_TRACKER_HOME=/custom/app-home

Clear app data

habit-tracker clear-data
habit-tracker clear-data --yes

clear-data shows the exact paths it plans to remove and asks for confirmation unless --yes is used.

Uninstall

If you installed with pipx:

pipx uninstall habit-tracker-cli

If you installed with pip:

pip uninstall habit-tracker-cli

There is intentionally no built-in self-uninstall command. Uninstall remains a manual step for safety.

Releases

Releases are published to PyPI through GitHub Actions using PyPI trusted publishing.

License

MIT