Task Timer CLI ⏱️

A simple command-line pomodoro timer and task tracker to boost your productivity!

Features

• 📝 Add and manage tasks
• ⏰ Built-in pomodoro timer
• 📊 Track completion statistics
• 💾 Persistent task storage
• 🎯 Simple and intuitive CLI
• 🖥️ With GUI support

Installation

1. Clone this repository:

git clone https://github.com/yourusername/task-timer-cli.git
cd task-timer-cli

2. Make the script executable (optional):

chmod +x task_timer.py

3. Run it!

python task_timer.py

Usage

Add a task

python task_timer.py add "Write documentation" 25

List all tasks

python task_timer.py list

Start a timer

python task_timer.py start 1

Delete a task

python task_timer.py delete 1

View statistics

python task_timer.py stats

Contributing

This project welcomes contributions for Hacktoberfest! 🎃

Please check out our open issues for ways to contribute. We have issues labeled good-first-issue for beginners!

How to contribute:

1. Fork the repository
2. Create a new branch (git checkout -b feature/your-feature)
3. Make your changes
4. Commit your changes (git commit -am 'Add some feature')
5. Push to the branch (git push origin feature/your-feature)
6. Create a Pull Request

License

MIT License - feel free to use this project for learning and improvement!

Roadmap

• Add break timer support
• Color-coded output
• Export tasks to CSV
• Task categories/tags
• Sound notifications
• GUI version
• Configuration file support

---

Made with ❤️ for Hacktoberfest 2025