🎯 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 ✅

<input checked="" disabled="" type="checkbox"> Task management
<input checked="" disabled="" type="checkbox"> Pomodoro timer
<input checked="" disabled="" type="checkbox"> XP and achievements
<input checked="" disabled="" type="checkbox"> Local SQLite storage
<input checked="" disabled="" type="checkbox"> Colorful Warp-optimized UI

v2.0 (Coming Soon)

<input disabled="" type="checkbox"> AI suggestions integration
<input disabled="" type="checkbox"> Team sharing and collaboration
<input disabled="" type="checkbox"> Cloud sync with Supabase
<input disabled="" type="checkbox"> Advanced analytics
<input disabled="" type="checkbox"> 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.

Package detail

focus-productivity-cli

readme