@vigneshrajsb/habits-cli
v0.2.1
Published
CLI for habit tracking with streaks, mood logging, and visual stats. SQLite-powered.
Downloads
350
Maintainers
Readme
habits-cli 🦊
A simple CLI for tracking habits and journaling, built with Bun and SQLite.
Install
npm install -g @vigneshrajsb/habits-cli
# or
pnpm add -g @vigneshrajsb/habits-cli
# or
bun add -g @vigneshrajsb/habits-cli
# one-shot (no install)
bunx @vigneshrajsb/habits-cli --help
npx @vigneshrajsb/habits-cli --helpRequires: Bun runtime (curl -fsSL https://bun.sh/install | bash)
Usage
Daily Overview
habits today # today's habits, mood, journal
habits week # last 7 days
habits history # current month
habits history 0226 # Feb 2026 (mmyy format)Habits
habits add "Workout" --emoji 💪
habits list
habits log workout # by name
habits log 1 # by number
habits done 1,2,4 # multiple at once
habits unlog 1 # remove log
# Streaks (visual!)
habits streak # all habits, 7 days
habits streak 14 # all habits, 14 days
habits streak gym # single habit, 7 days
habits streak gym 30 # single habit, 30 days
habits deactivate workout
habits activate workoutJournal
habits journal write "Had a great day"
habits journal read
habits journal read --last 7
habits journal search "interview"Mood
habits mood 4 # 1=😞 2=😕 3=😐 4=🙂 5=😄
habits mood history # last 7 days
habits mood history 30 # last 30 daysOptions
--date YYYY-MM-DD # specify date
--json # JSON outputData Storage
Data stored in ~/.habits/habits.db (SQLite).
habits db # show pathAI Agent Integration
See AGENTS.md for detailed agent usage.
License
MIT
