🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Habit Tracker

by @harrylabsj

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...

Versionv1.0.0
Downloads351
TERMINAL
clawhub install habits-tracker

πŸ“– About This Skill


name: habits-tracker version: 1.0.0 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 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 definitions
  • logs.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
    

    πŸ’‘ 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