taskman-cli

📝 Description

TaskMan CLI is a powerful and user-friendly task management application built with Python using the ttask-manager package. It offers a seamless command-line interface for efficiently managing your daily tasks, helping you boost productivity and stay organized.

Important Note: As of 01/19/2025, TaskMan CLI repo was archived and now this is the main TaskMan CLI repo, the '-PyPi' will remain due to the existence of TaskMan CLI.

✨ Features

• 📌 Add Tasks and Specify their Priorities: Easily add new tasks with priorities to your to-do list
• 🗑️ Remove Tasks: Remove tasks from your to-do list
• ✅ Mark Tasks as Completed: Move tasks to a "done" list when completed
• 👀 View Current State: See all your tasks, both pending and completed
• 🧹 Clear Lists: Clean up your to-do and done lists with a single command
• 💾 Data Persistence: Your tasks are saved automatically, so you never lose your progress
• 📊 Generate Reports: Create daily task reports to track your productivity

🚀 Installation

You can install TaskMan CLI using pip:

pip install taskman-cli

🛠️ Usage

After installation, you can start TaskMan CLI by running:

taskman

Once launched, you'll see the TaskMan welcome screen. Type help to see available commands:

TaskMan > help

Use the various commands to manage your tasks. Here are some examples:

TaskMan > add Buy groceries | Call mom:high | Finish report
TaskMan > list-todo
TaskMan > mark-as-done Buy groceries
TaskMan > list-both

📚 Available Commands

• add [task1:priority] | [task2] | ...: Add one or more tasks with their priorities
• remove [task1] | [task2] | ...: Remove one or more tasks
• mark-as-done / mad [task1]...: Mark one or more tasks as completed
• list-both / lb: Show all tasks (to-do and done)
• list-todo / ltd: Show pending tasks
• list-done / ld: Show completed tasks
• clear-todo / cltd: Clear all pending tasks
• clear-done / cld: Clear all completed tasks
• reset: Clear all tasks (both to-do and done)
• report [name]: Generate a report (optional custom name, defaults to current_date.txt)
• save: Save current state to file
• help: Show the help message
• clear / Ctrl+l: Clear the screen
• exit: Exit the program

📶 Available Priorities

The available task priorities are:

• high
• medium (default one)
• low

💡 Tips

• Use the up and down arrow keys to navigate through your command history.
• TaskMan supports auto-completion. Start typing a command and press Tab to complete it.
• If a task is passed without specifying the priority (e.g: add code) the priority will default to medium
• Your tasks can be saved, so you can safely exit with saving the current state and resume your work later.

🤝 Contributing

Contributions are welcome! Here's how you can contribute:

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

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Inspired by the ZTM Python course by Andrei Neagoie
• Built with love using Python and prompt_toolkit

📞 Contact

If you have any questions, feel free to reach out:

• Gmail - [e-mail]
• Project Link: TaskMan-CLI-PyPi

---

Made with ❤️ by Taha Yasser Adnan