JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 8
  • Score
    100M100P100Q87760F
  • License MIT

AI-powered productivity automation system that learns from your coding patterns to optimize focus sessions and daily routines

Package Exports

  • productivity-ai-cli
  • productivity-ai-cli/lib/productivity-ai.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (productivity-ai-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🚀 Productivity AI CLI

npm version npm downloads License: MIT

The only productivity system that learns from your code to optimize your focus sessions.

An AI-powered productivity automation CLI that analyzes your Git activity, categorizes TODOs by urgency, and adapts focus session durations to maximize your efficiency. Built specifically for developers who want intelligent automation, not just timers.

✨ What Makes This Special

  • 🧠 AI-Powered Optimization: Learns from your Git patterns to suggest optimal focus durations (15-45 minutes)
  • 📊 Smart TODO Analysis: Automatically categorizes tasks by urgency using keyword detection
  • 🔄 Complete Daily Automation: Morning planning → Midday review → Evening insights
  • 📈 Performance Analytics: Track productivity trends and patterns over time
  • 🎯 Developer-Centric: Git integration, code-aware productivity, TODO scanning
  • ⚡ Zero Configuration: Works out of the box, improves over time

🚀 Quick Start

# Install globally
npm install -g productivity-ai-cli

# Initialize in your project
productivity init

# Start maximum efficiency mode
productivity turbo

# Begin your first focus session
productivity start

📊 How It Works

1. AI Analyzes Your Work Patterns

$ productivity optimize
🧠 Analyzing Git activity: 15 commits (high intensity)
🎯 Recommended: 45-minute deep work session
⚡ Auto-starting optimized session...

2. Smart TODO Priority Detection

  • 🔴 High Priority: TODO: URGENT - Fix critical bug !!!
  • 🟡 Medium Priority: TODO: Important - Add user feedback !!
  • 🟢 Low Priority: TODO: Refactor helper function

3. Adaptive Focus Sessions

  • Sprint (15min): Low activity, momentum building
  • Standard (25min): Normal productivity flow
  • Deep Work (45min): High activity, complex problems
  • Review (20min): Code review and cleanup

🎮 Commands

productivity turbo           # Activate all automation systems
productivity start [type]    # Focus session (sprint|standard|deep|review)
productivity dashboard       # Real-time productivity metrics
productivity optimize        # AI optimization for current time
productivity insights        # Weekly analytics and trends
productivity status          # System diagnostics
productivity reset           # Emergency recovery

📈 Features

AI-Powered Intelligence

  • Git Activity Analysis: Analyzes commit frequency, urgency keywords, file changes
  • Performance Prediction: Forecasts daily productivity using historical patterns
  • Context-Aware Optimization: Time-of-day and workload-based recommendations
  • Continuous Learning: Improves recommendations based on your usage patterns

Complete Automation

  • Daily Routines: Automated morning planning, midday review, evening wrap-up
  • Smart Scheduling: Intelligent cron job setup with micro-break reminders
  • Background Monitoring: File change detection and workspace analysis
  • Emergency Recovery: Comprehensive reset and diagnostic capabilities

Developer Integration

  • Git Repository Analysis: Multi-repo support with activity scoring
  • TODO Comment Scanning: Automatic priority detection across multiple languages
  • Development Environment Detection: Auto-detects Node.js, Python, Rust, Go projects
  • Cross-Platform: Works on Linux, macOS, WSL

📊 Analytics Dashboard

$ productivity insights

📈 Weekly Productivity Insights
===============================
Mon 10/07: 6 sessions, git score: 23  📈 High
Tue 10/08: 4 sessions, git score: 12  📊 Normal  
Wed 10/09: 8 sessions, git score: 31  🔥 Excellent
Thu 10/10: 5 sessions, git score: 18  📈 High
Fri 10/11: 3 sessions, git score: 8   📉 Low

📊 Weekly Summary:
├─ Total sessions: 26
├─ Average per day: 5.2
├─ Completion rate: 87%
└─ Productivity trend: 📈 Improving

🛠️ Configuration

The system creates .productivity/automation_config.json with sensible defaults:

{
  "auto_focus_duration": 25,
  "break_reminder": true,
  "git_repos": ["./"],
  "priority_categories": ["urgent", "important", "routine"],
  "notification_methods": ["terminal", "log"],
  "learning_mode": true
}

🎯 Use Cases

For Individual Developers

  • Remote Work: Structure and accountability for home office
  • Deep Work: AI-optimized focus sessions for complex coding
  • Productivity Tracking: Data-driven insights into work patterns
  • Habit Building: Automated routines reduce decision fatigue

For Development Teams

  • Team Productivity: Shared goals and accountability
  • Code Review Sessions: Structured review time with TODO analysis
  • Sprint Planning: AI insights for realistic sprint sizing
  • Performance Analytics: Team productivity trends and optimization

🚀 Advanced Features

Machine Learning Integration

# AI learns your patterns over time
Week 1: Basic recommendations
Week 2: Pattern recognition begins
Week 3+: Highly accurate personalized optimization

Real-time Monitoring

# Optional: Install for enhanced features
sudo apt install inotify-tools  # File change monitoring
pip install gcalcli            # Google Calendar integration

Team Collaboration

# Multi-user setup for teams
productivity init --team
productivity dashboard --shared

📱 Integration Examples

VS Code Integration

// .vscode/tasks.json
{
  "label": "Focus Session",
  "type": "shell",
  "command": "productivity start deep"
}

Git Hooks

# .git/hooks/pre-commit
#!/bin/bash
productivity start review

Cron Automation

# Automatic daily routines
0 9 * * *   productivity optimize     # Morning optimization
0 12 * * *  productivity insights     # Midday review  
0 17 * * *  productivity dashboard    # Evening summary

🔧 Troubleshooting

Common Issues

# System diagnostics
productivity status

# Reset if needed
productivity reset

# Reinstall scripts
rm -rf .productivity && productivity init

Platform-Specific Notes

  • Linux/macOS: Full feature support
  • Windows WSL: Recommended for best experience
  • Windows Native: Basic functionality (file monitoring limited)

📊 Performance Metrics

  • Startup Time: < 2 seconds
  • Memory Usage: < 50MB
  • Storage: ~1KB per day of metrics
  • CPU Impact: < 1% during operation

🤝 Contributing

We welcome contributions! Here's how to get started:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Make your changes and add tests
  4. Commit your changes: git commit -m 'Add amazing feature'
  5. Push to the branch: git push origin feature/amazing-feature
  6. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Built for the developer community
  • Inspired by the Pomodoro Technique with AI enhancement
  • Designed for the remote work era

📞 Support

  • 📖 Documentation: See detailed guides in the repository
  • 🐛 Issues: Report bugs or request features on GitHub
  • 💬 Community: Join discussions and share productivity tips
  • 📧 Contact: Reach out for support or collaboration

Transform your productivity with AI that learns from your code. ⚡

npm install -g productivity-ai-cli