time-analyzer

# 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 - **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 ```bash # 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 ```bash # 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: ```bash # 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 ```bash # Global installation npm install -g time-analyzer # Or use npx npx time-analyzer ```