doxa/doxa-habit/MANUAL.md

DOXA Habit User Manual 🎯

This manual describes how to navigate and manage habits in the DOXA Habit tracker.

Getting Started

Start the application by running:

doxa-habit

Press Enter on the splash screen to enter the main interface.

Interface States

1. MAIN VIEW: A list showing all your habits, their current streaks (e.g., 🔥3 for 3 consecutive days, or ❄️0), and a mini calendar heatmap showing the last 7 days (▓ for completed, ░ for missed).
2. DETAIL MODAL: Displays description, frequency, stats for last 7/30 days, and a detailed heatmap.
3. STATS VIEW: Table summarizing all your habits' statistics.
4. ADD / EDIT FORM: Text inputs to add or modify habits.

Controls

Main Screen

• 1: Add a new habit.
• 2: Edit the selected habit.
• 3: Export completion history to ~/.doxa-habit/export/<habit_name>_history.csv.
• 4: Delete selected habit.
• t: Toggle today's status (Completed ✅ vs Not Completed ⬜).
• s: Show statistics of all habits.
• l: Switch UI language (English/Czech).
• /: Filter habits by search term.
• Enter: Open details modal.
• q / Esc: Exit the program.

Form Fields (Add/Edit)

• Tab: Jump between the "Name" and "Description" fields.
• f: Toggle habit frequency between "Daily" and "Weekly".
• Enter: Save and create/modify the habit.
• q / Esc: Go back to the main list without saving.

Modal & Stats Views

• q / Esc: Return to the main list view.