doxa/doxa-habit

DOXA Habit 🎯

Minimalist habit tracker for the terminal with streak tracking

DOXA Habit is a terminal-based tool to organize, record, and maintain daily and weekly habits. It calculates streaks and offers a visual 7-day mini heatmap of your progress.

Features

• Daily & Weekly Habits: Setup name, description, and execution frequency.
• Completion toggle: Mark today as completed or not.
• Streak & Heatmap: Displays your current streak (🔥/❄️) and a mini calendar (▓/░) of the last 7 days.
• Overall Statistics: Success rates over 7 and 30 days.
• Local JSON Storage: Kept securely offline at ~/.doxa-habit/doxa_habit.json.
• Export to CSV: Export your habit completion log history.
• Bilingual: CZ/EN language support via the l key.

Installation

cd doxa-habit
chmod +x install.sh
./install.sh

Hotkeys

• 1 - Add Habit
• 2 - Edit selected Habit
• 3 - Export selected Habit history to CSV
• 4 - Delete Habit
• t - Toggle completed state for today
• s - View Overall Statistics
• l - Toggle language (EN/CS)
• / - Search habits by name
• Enter - View Habit Details Modal
• q / Esc - Go back / Quit