/install habits-tracker
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 list
Log 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 7
View Statistics
node scripts/habit-cli.js stats "Exercise" --days 30
Shows:
- Total completions
- Active days
- Completion rate
- Current streak
- Longest streak
Generate Report
node scripts/habit-cli.js report --days 7
Displays 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 reminder
Data 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 reminder
Daily Report
0 21 * * * node /path/to/habit-tracker/scripts/habit-cli.js report --days 1
Integration
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 1
View progress:
habit stats --days 30
habit report --days 7
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install habits-tracker - After installation, invoke the skill by name or use
/habits-tracker - Provide required inputs per the skill's parameter spec and get structured output
What is Habit Tracker?
Track habits, log completions, and analyze progress with CLI commands. Use when user wants to build habits, track daily/weekly/monthly routines, log habit co... It is an AI Agent Skill for Claude Code / OpenClaw, with 230 downloads so far.
How do I install Habit Tracker?
Run "/install habits-tracker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Habit Tracker free?
Yes, Habit Tracker is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Habit Tracker support?
Habit Tracker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Habit Tracker?
It is built and maintained by haidong (@harrylabsj); the current version is v1.0.0.