Skip to main content

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


Download files

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

Source Distribution

termdo-1.0.0.tar.gz (3.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

termdo-1.0.0-py3-none-any.whl (4.0 kB view details)

Uploaded Python 3

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

Hashes for termdo-1.0.0.tar.gz
Algorithm Hash digest
SHA256 30d8dd3d1542fab52e9323ac98733edf2601aa84f75455e39f61515a084323de
MD5 ea5dd41dca721b34b9eb488b464b971c
BLAKE2b-256 baeafe6d50b4581eeb8c2155c53dc1fb41d825eaf44fe070b5fe0c24f615ea88

See more details on using hashes here.

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

Hashes for termdo-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 958cba4afc6b819b4c5931f477b95f1042705d876554db44c5d7fd3cf6805d2f
MD5 8ceedc76e42841c131e1b0e5ee99497f
BLAKE2b-256 32522c7d96d6b6713d08e2508c19678cfb248cffeee65e64b32ca3a8fc13d64e

See more details on using hashes here.

Supported by

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