This is a lightweight Task Manager CLI built in Python using SQLite for storage. It lets you manage tasks straight from your terminal — fast, simple, and distraction-free.
✨ What you can do:
- Create, list, update, and delete tasks (CRUD operations).
- View tasks in a clean, colorful terminal table (thanks to Rich).
- Easy to install and run anywhere with Python.
|-- images/
| -- tasks.png # Screenshot showing available commands
|-- task_manager/
| -- __init__.py
| -- cli.py # CLI entry point (Click commands)
| -- commands.py # Database logic (SQLite actions)
|-- tests/
| -- __init__.py
| -- test_db.py # Unit tests
|-- .gitignore
|-- LICENSE
|-- README.md
|-- requirements.txt # Dependencies
|-- setup.py # Packaging & entry point (installs `tasks` command)Requirements:
- Python 3.7+
- pip
Steps:
-
Clone the repo:
git clone https://github.com/bmuia/TaskCLI.git cd TaskCLI -
Install dependencies:
pip install -r requirements.txt
-
Install the CLI locally:
pip install -e .
Open your terminal inside the project root, then run:
tasksYou’ll see all available commands:
Examples:
tasks list # show all tasks
tasks add # add a new task (prompts for details)
tasks update # update a task by ID
tasks show # show details for one task
tasks delete # delete a task by IDIf something doesn’t work:
- Make sure you’re inside a virtual environment (
python -m venv venv && source venv/bin/activate). - Run
pip install -e .again after changes. - Check that your SQLite database (
tests.db) exists — the app should create it automatically. - Open an issue or email me at belammuia0@gmail.com.
Got ideas? Found a bug?
- Open an issue
- Or make a pull request 🚀
MIT License – see the LICENSE file for details.
This project is meant to be simple and practical — a CLI to manage tasks without distractions. If you like it, feel free to ⭐ the repo and extend it with new features!
