🎯 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

$3

#### Option 1: NPM Global Install (Recommended)
``bash

Install globally from NPM

npm install -g @focuscli/focus-cli

Use anywhere

focus add "My first task"
`

#### Option 2: Download and Run
`bash

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)
`bash

In project directory

npm link
focus add "My task"
`

$3

`bash

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

$3

- 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 - Mark task as complete

$3

- focus start - Start 25-minute Pomodoro session
- focus start - Start custom duration session
- focus stop - Stop current session

$3

- 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

$3

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

$3

- [ ] 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.