An ADHD-friendly productivity CLI tool built to run inside Warp terminal
npm install focus-productivity-clibash
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`: