A minimalist, local-first TUI for tracking daily habits. Built with Go and Bubble Tea.

Features

• Local-first: All data stored locally in SQLite
• Flexible scheduling: Daily, weekly, or X times per week
• Streak tracking: Monitor your consistency with automatic streak calculation
• Categories: Organize habits with color-coded categories
• Stats panel: Always-visible statistics sidebar with completion rates and sparklines
• Keyboard-driven: Vim-style navigation (j/k) and intuitive shortcuts

Installation

Using Go (Recommended)

go install github.com/vittolewerissa/hbt/cmd/hbt@latest

Then run:

hbt

From Source

git clone https://github.com/vittolewerissa/hbt.git
cd hbt
go build -o hbt ./cmd/hbt
./hbt

Usage

Navigation

Key	Action
j / k	Move down / up
Tab	Next tab
Shift+Tab	Previous tab
q	Quit

Today Tab

Key	Action
Space / Enter	Toggle habit completion

Habits Tab

Key	Action
a	Add new habit
e	Edit selected habit
d	Delete selected habit

Data Storage

Data is stored in ~/.habit-cli/habits.db (SQLite database).

Tech Stack

• Go
• Bubble Tea - TUI framework
• Lip Gloss - Styling
• Bubbles - TUI components
• modernc.org/sqlite - Pure Go SQLite

License

MIT