Time Analyzer
by @harrylabsj
Time tracking and analysis skill for automatic activity monitoring and productivity insights. Use when the user wants to track time spent on activities, anal...
clawhub install time-analyzer📖 About This Skill
name: time-analyzer description: Time tracking and analysis skill for automatic activity monitoring and productivity insights. Use when the user wants to track time spent on activities, analyze time usage patterns, get productivity suggestions, or generate time reports. Triggers on phrases like "track my time", "analyze my time", "time report", "productivity analysis", "how am I spending my time", "time tracking", "start tracking", "stop tracking", "time suggestions", "time optimization".
Time Analyzer
Time Analyzer is a time tracking and analysis tool that helps users record activities, analyze time usage patterns, and generate practical suggestions for improvement.
Features
Usage
CLI Commands
# Start tracking an activity
time-analyzer start [description] [tags]Stop current activity
time-analyzer stopView current status
time-analyzer statusAnalyze time data (default: past 7 days)
time-analyzer analyze [days]Generate optimization suggestions
time-analyzer suggestGenerate full report
time-analyzer report [days]Manually add a record
time-analyzer add List all categories
time-analyzer categoriesShow help
time-analyzer help
Activity Categories
| Category | Description | Icon | |----------|-------------|------| | work | Work | 💼 | | study | Study | 📚 | | meeting | Meeting | 👥 | | break | Break | ☕ | | exercise | Exercise | 🏃 | | entertainment | Entertainment | 🎮 | | sleep | Sleep | 😴 | | other | Other | 📌 |
Usage Examples
# Start tracking work
time-analyzer start work "Developing new feature"Start tracking study
time-analyzer start study "Reading technical documentation"End current activity
time-analyzer stopAnalyze past 30 days
time-analyzer analyze 30Get optimization suggestions
time-analyzer suggestManually add 1 hour meeting record
time-analyzer add meeting "Weekly sync" 60
Data Storage
Data is stored in the .time-analyzer/ folder in the user's home directory:
records.json: All activity recordsconfig.json: Configuration and current session stateReport Content
Analysis reports include: 1. Overview: Total activities, total duration, daily average statistics 2. Category Details: Time percentage and frequency for each category 3. Active Periods: Most active time periods during the day 4. High-Frequency Activities: Top 5 most common activities 5. Optimization Suggestions: Time management suggestions based on data
Automatic Tracking
The current version supports manual start/stop tracking. Automatic reports can be enabled via cron jobs:
# Add to crontab to generate daily report at 22:00
echo "0 22 * * * /usr/local/bin/time-analyzer report" | crontab -
Dependencies
Installation
# Global installation
npm install -g time-analyzerOr use npx
npx time-analyzer
💡 Examples
CLI Commands
# Start tracking an activity
time-analyzer start [description] [tags]Stop current activity
time-analyzer stopView current status
time-analyzer statusAnalyze time data (default: past 7 days)
time-analyzer analyze [days]Generate optimization suggestions
time-analyzer suggestGenerate full report
time-analyzer report [days]Manually add a record
time-analyzer add List all categories
time-analyzer categoriesShow help
time-analyzer help
Activity Categories
| Category | Description | Icon | |----------|-------------|------| | work | Work | 💼 | | study | Study | 📚 | | meeting | Meeting | 👥 | | break | Break | ☕ | | exercise | Exercise | 🏃 | | entertainment | Entertainment | 🎮 | | sleep | Sleep | 😴 | | other | Other | 📌 |
Usage Examples
# Start tracking work
time-analyzer start work "Developing new feature"Start tracking study
time-analyzer start study "Reading technical documentation"End current activity
time-analyzer stopAnalyze past 30 days
time-analyzer analyze 30Get optimization suggestions
time-analyzer suggestManually add 1 hour meeting record
time-analyzer add meeting "Weekly sync" 60