- name
- habit-tracker
- description
- Track habits, log completions, and analyze progress with CLI commands. Use when user wants to build habits, track daily/weekly/monthly routines, log habit completions, view statistics, generate reports, or set up habit reminders. Supports habit creation, logging, statistics analysis, streak tracking, and progress reports.
Habit Tracker
A command-line habit tracking tool for building consistency and monitoring progress.
Features
- Habit Definition: Create habits with custom frequency (daily/weekly/monthly), targets, and reminders
- Habit Logging: Log completions manually with optional notes and custom dates
- Statistics: View completion rates, streaks, and trends
- Progress Reports: Visual progress bars and summary reports
- Smart Reminders: Check for due habits based on reminder times
Installation
The habit tracker is available as a Node.js CLI tool. No dependencies required.
CLI Commands
Add a Habit
node scripts/habit-cli.js add "Exercise" --frequency daily --target 1 --reminder "08:00"Options:
--frequency: daily, weekly, or monthly (default: daily)--target: completions per period (default: 1)--reminder: time in HH:MM format--description: habit description
List Habits
node scripts/habit-cli.js listLog a Completion
node scripts/habit-cli.js log "Exercise" --count 1 --note "Morning run"Options:
--count: number of completions (default: 1)--date: YYYY-MM-DD format (default: today)--note: optional note
View Logs
node scripts/habit-cli.js logs "Exercise" --days 7View Statistics
node scripts/habit-cli.js stats "Exercise" --days 30Shows:
- Total completions
- Active days
- Completion rate
- Current streak
- Longest streak
Generate Report
node scripts/habit-cli.js report --days 7Displays visual progress bars and summary for all habits.
Edit a Habit
node scripts/habit-cli.js edit "Exercise" --target 2 --reminder "07:00"Delete a Habit
node scripts/habit-cli.js delete "Exercise"Check Reminders
node scripts/habit-cli.js reminderData Storage
Habits and logs are stored in ~/.config/habit-tracker/:
habits.json: Habit definitionslogs.json: Completion logs
Automation
Cron Job for Reminders
Add to crontab for hourly reminder checks:
0 * * * * node /path/to/habit-tracker/scripts/habit-cli.js reminderDaily Report
0 21 * * * node /path/to/habit-tracker/scripts/habit-cli.js report --days 1Integration
This skill can be triggered by:
- Direct CLI commands
- Scheduled cron jobs
- Event-based triggers (e.g., after completing a task)
Examples
Track a new habit:
habit add "Read 30 minutes" --frequency daily --target 1 --reminder "21:00"
habit log "Read 30 minutes" --note "Finished chapter 5"Weekly habit with multiple targets:
habit add "Meditate" --frequency weekly --target 5
habit log "Meditate" --count 1View progress:
habit stats --days 30
habit report --days 7