← Back to Skills Marketplace
harrylabsj

Habit Tracker

by haidong · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
230
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install habits-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 co...
README (SKILL.md)

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
Usage Guidance
This skill is internally consistent with being a local Node.js CLI habit tracker: it stores data under ~/.config/habit-tracker and does not ask for credentials or make network calls in the visible portion. Before installing or running it, (1) inspect the full scripts/habit-cli.js file (the provided listing was truncated in the review input) to confirm there are no hidden network calls or suspicious behavior, (2) ensure you have Node.js >=18 as declared, (3) be aware it will create and modify files in ~/.config/habit-tracker so set appropriate file permissions if you care about privacy, and (4) only add cron entries if you understand the exact path/command they will run. If you want higher assurance, run the script in a controlled environment (container or VM) first.
Capability Analysis
Type: OpenClaw Skill Name: habits-tracker Version: 1.0.0 The habit-tracker skill is a standard CLI tool for managing personal habits, logging completions, and viewing statistics. The core logic in `scripts/habit-cli.js` is well-structured, using local JSON files stored in the user's home directory (`~/.config/habit-tracker/`) for data persistence. There is no evidence of network activity, unauthorized file access, or malicious instructions in the documentation or code.
Capability Assessment
Purpose & Capability
Name/description (CLI habit tracking, logging, stats, reminders) matches the included package.json and CLI script. The files, CLI commands, data storage path, and suggested cron usage are appropriate for this purpose.
Instruction Scope
SKILL.md only instructs running the local Node.js script, managing habits, and optionally adding cron jobs for reminders/reports. The instructions reference only the local data directory (~/.config/habit-tracker) and expected CLI arguments; they do not request unrelated files, credentials, or external endpoints.
Install Mechanism
No install spec is declared (instruction-only), and package.json has no dependencies. The CLI is implemented as a Node.js script that the user runs directly. There are no downloads or external install URLs, which minimizes install risk.
Credentials
No environment variables, credentials, or config paths are requested. The script only uses the user's home directory to store habit data, which is proportional to its functionality.
Persistence & Privilege
The skill writes persistent data to ~/.config/habit-tracker (habits.json and logs.json), which is expected. always is false and autonomous invocation is allowed by platform default. This local persistence is normal for a CLI tool but you should be aware data is stored on disk.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install habits-tracker
  3. After installation, invoke the skill by name or use /habits-tracker
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the habits-tracker CLI tool. - Track custom habits with flexible frequencies and reminders - Manually log completions, including notes and custom dates - View statistics: completion rates, streaks, and activity trends - Generate visual progress reports and summaries - Edit and delete habits; all data stored locally in your config directory - Designed for easy automation via cron or CLI integration
Metadata
Slug habits-tracker
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

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.

💬 Comments