Skip to main content

A minimalistic and user-friendly task management application built with Python

Project description

TaskMan CLI

📝 Description

TaskMan CLI is a powerful and user-friendly task management application built with Python. It offers a seamless command-line interface for efficiently managing your daily tasks, helping you boost productivity and stay organized.
Important Note: This project is for learning purposes and is based on the original script by me. The original repository can be found at TaskMan CLI repo.

✨ Features

  • 📌 Add Tasks: Easily add new tasks 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 | Finish report
TaskMan > list-todo
TaskMan > mark-as-done Buy groceries
TaskMan > list-both

📚 Available Commands

  • add [task1] | [task2] | ...: Add one or more tasks
  • 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)
  • save: Save current state to file
  • help: Show the help message
  • clear / Ctrl+l: Clear the screen
  • exit: Exit the program

💡 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.
  • 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

Please make sure to update tests as appropriate.

📄 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:


Made with ❤️ by Taha Yasser Adnan

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

taskman_cli-0.2.8.tar.gz (6.2 kB view details)

Uploaded Source

Built Distribution

taskman_cli-0.2.8-py3-none-any.whl (6.5 kB view details)

Uploaded Python 3

File details

Details for the file taskman_cli-0.2.8.tar.gz.

File metadata

  • Download URL: taskman_cli-0.2.8.tar.gz
  • Upload date:
  • Size: 6.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for taskman_cli-0.2.8.tar.gz
Algorithm Hash digest
SHA256 4e7d43501a5f95bc5f87d8f323ea7a6ea6795db9734f28372aabc4129fae702a
MD5 052a4e12c469e41667dee4e091d8efd8
BLAKE2b-256 44fa939fda75e0af4fe89c654affec7b2caab4b2b22553a4d88b3e4aa57a5b61

See more details on using hashes here.

File details

Details for the file taskman_cli-0.2.8-py3-none-any.whl.

File metadata

  • Download URL: taskman_cli-0.2.8-py3-none-any.whl
  • Upload date:
  • Size: 6.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for taskman_cli-0.2.8-py3-none-any.whl
Algorithm Hash digest
SHA256 1d27b807aa5821cf69fdd5cb6b7c16cfbb7793a73c37cdb36b6379f1cfbf3bb9
MD5 02f809920b93ca41016f61110e700aca
BLAKE2b-256 f4089cdf5984b37a7ae7d3ba635231b31e9ad9b04e5031a97b5cee8b365c88a7

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page