🎯 FocusCLI

An ADHD-friendly productivity CLI tool built to run inside Warp terminal. Helps users focus, gamify tasks, and collaborate with minimal friction.

✨ Features

• 🎮 Gamified Productivity: XP points, levels, and achievements
• ⏱️ Pomodoro Timer: Live progress updates with encouragement
• 🔥 Daily Streaks: Build consistent habits
• 📋 Simple Task Management: One task at a time focus
• 🌈 Beautiful UI: Colorful output optimized for Warp terminal
• 🧠 ADHD-Friendly: Designed for neurodivergent minds

🚀 Quick Start

Installation Options

Option 1: NPM Global Install (Recommended)

# Install globally from NPM
npm install -g @focuscli/focus-cli

# Use anywhere
focus add "My first task"

Option 2: Download and Run

# Download/clone project
npm install

# Use with Node.js
node src/index.js add "My task"

# Or use batch file (Windows)
.\focus.bat add "My task"

Option 3: Global Link (Development)

# In project directory
npm link
focus add "My task"

Basic Usage

# Add your first task
focus add "Complete project documentation"

# View your tasks
focus list

# Start a 25-minute focus session
focus start

# Complete a task (earn XP!)
focus done 1

# Check your progress
focus stats

📚 Commands

Task Management

• focus add "task description" - Add a new task
• focus add "task" -p high - Add high priority task
• focus list - Show pending tasks
• focus list -a - Show all tasks (including completed)
• focus done <id> - Mark task as complete

Focus Sessions

• focus start - Start 25-minute Pomodoro session
• focus start <minutes> - Start custom duration session
• focus stop - Stop current session

Progress & Stats

• focus stats - View productivity statistics
• focus welcome - Show welcome message and help

🏆 Achievements

Unlock achievements by completing tasks and focus sessions:

• 🌱 Getting Started - Complete your first task
• 🔥 On a Roll - Complete 3 tasks
• ⚡ Productivity Machine - Complete 10 tasks
• 🧠 Focus Master - Complete a 25+ minute focus session
• 🏆 Daily Warrior - 3-day streak
• 💎 Centurion - Earn 1000 total XP

🎯 ADHD-Friendly Design

FocusCLI is specifically designed for ADHD minds:

• One task at a time - Avoid overwhelm
• Instant gratification - XP and visual feedback
• Flexible sessions - 10-45 minute focus sessions
• Encouraging messages - Positive reinforcement
• Visual progress - Beautiful progress bars and colors
• Habit building - Daily streaks for consistency

🛠 Tech Stack

• Node.js - Runtime environment
• Commander.js - CLI framework
• SQLite - Local data storage
• Chalk - Terminal colors
• Warp Terminal - Optimized for blocks and AI

📊 Data Storage

All data is stored locally in ~/.focuscli/focus.db:

• Tasks and completion status
• Focus session history
• XP, levels, and achievements
• Daily streak tracking

🔮 Roadmap

MVP ✅

• [x] Task management
• [x] Pomodoro timer
• [x] XP and achievements
• [x] Local SQLite storage
• [x] Colorful Warp-optimized UI

v2.0 (Coming Soon)

• [ ] AI suggestions integration
• [ ] Team sharing and collaboration
• [ ] Cloud sync with Supabase
• [ ] Advanced analytics
• [ ] Custom themes

🤝 Contributing

Built with ❤️ for the ADHD community and productivity enthusiasts. Contributions welcome!

📄 License

MIT License - feel free to fork and improve!

Made with 🎯 for Warp Terminal users who want to stay focused and productive.