A terminal-based todo app with colored output, categories and priorities
Project description
termdo
termdo is a lightweight, fast, terminal-based to-do manager with natural commands, subcommands, colored output, categories, and priorities.
Designed for developers and power users who want a clean, intuitive workflow without leaving the terminal.
🚀 Features
✔ Simple Commands
termdo add "Buy groceries"
termdo done 2
termdo delete 3
termdo list
✔ Custom Syntax Support
1. Complete assignment
done task 1
✔ Categories & Priorities
termdo add "Finish report" --category work --priority high
termdo list --category work
✔ Colored Output (Rich)
- High priority → 🔴 Red
- Medium → 🟡 Yellow
- Low → 🟢 Green
- Completed tasks → dim or green checkmark
✔ Human-friendly storage
Uses JSON for easy portability.
📦 Installation
Once published to PyPI:
pip install termdo
Or install locally for development:
pip install .
📝 Usage
Add a task
termdo add "Buy milk"
Add with category + priority:
termdo add "Finish project" --category work --priority high
List tasks
termdo list
Filter:
termdo list --category personal
termdo list --priority high
Mark task as done
termdo done 3
Delete a task
termdo delete 2
📁 Storage Format
~/.termdo/tasks.json contains:
{
"text": "Buy milk",
"done": false,
"category": "personal",
"priority": "medium"
}
🛠 Developer Notes
Install in editable mode
pip install -e .
Project Structure
termdo/
│
├── termdo/
│ ├── __init__.py
│ ├── cli.py
│
├── README.md
├── pyproject.toml
📜 License
MIT License © 2025 Akash Nandy
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file termdo-1.0.0.tar.gz.
File metadata
- Download URL: termdo-1.0.0.tar.gz
- Upload date:
- Size: 3.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
30d8dd3d1542fab52e9323ac98733edf2601aa84f75455e39f61515a084323de
|
|
| MD5 |
ea5dd41dca721b34b9eb488b464b971c
|
|
| BLAKE2b-256 |
baeafe6d50b4581eeb8c2155c53dc1fb41d825eaf44fe070b5fe0c24f615ea88
|
File details
Details for the file termdo-1.0.0-py3-none-any.whl.
File metadata
- Download URL: termdo-1.0.0-py3-none-any.whl
- Upload date:
- Size: 4.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
958cba4afc6b819b4c5931f477b95f1042705d876554db44c5d7fd3cf6805d2f
|
|
| MD5 |
8ceedc76e42841c131e1b0e5ee99497f
|
|
| BLAKE2b-256 |
32522c7d96d6b6713d08e2508c19678cfb248cffeee65e64b32ca3a8fc13d64e
|