Time Analyzer

Time tracking and analysis skill for automatic activity monitoring and productivity insights. Use when the user wants to track time spent on activities, anal...

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

• Time Tracking: Automatic activity start/end tracking, support for manual entries
• Activity Categorization: 8 preset categories (work, study, meeting, break, exercise, entertainment, sleep, other)
• Time Analysis: Category statistics, active period analysis, high-frequency activity identification
• Optimization Suggestions: Personalized time management suggestions based on data
• Report Generation: Generate comprehensive time usage reports

Usage

CLI Commands

# Start tracking an activity
time-analyzer start <category> [description] [tags]

# Stop current activity
time-analyzer stop

# View current status
time-analyzer status

# Analyze time data (default: past 7 days)
time-analyzer analyze [days]

# Generate optimization suggestions
time-analyzer suggest

# Generate full report
time-analyzer report [days]

# Manually add a record
time-analyzer add <category> <description> <minutes>

# List all categories
time-analyzer categories

# Show 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 stop

# Analyze past 30 days
time-analyzer analyze 30

# Get optimization suggestions
time-analyzer suggest

# Manually 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 records
• config.json: Configuration and current session state

Report 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

• Node.js >= 18.0.0
• No external dependencies (pure Node.js implementation)

Installation

# Global installation
npm install -g time-analyzer

# Or use npx
npx time-analyzer