Skip to main content

A CLI tool for managing todos directly from the terminal

Project description

Todo CLI 🚀

Python 3.6+ PyPI Version

A beautiful terminal-based todo manager with database persistence and rich visual feedback. Organize tasks directly from your command line with style! ✨

Features 🌟

  • 🎨 Rich Terminal UI with colored output and emojis
  • 📂 SQLite Database with automatic migrations
  • 🏷️ Priority Levels (Low/Medium/High)
  • 🔄 Progress Tracking (New/In Progress/Completed)
  • 📆 Automatic Timestamping for task creation
  • 🗑️ Safe Deletion with soft delete functionality
  • 📦 Packaged Application easy installation via PyPI

Installation 💻

# Install from PyPI
pip install todo-cli

# Install development version
pip install git+https://github.com/mehranmv/todo-cli.git

Usage 🛠️

# Add a new todo (interactive prompt)
todo add

# List active todos
todo list

# List all todos including completed
todo list-all

# Mark todo as in progress
todo progress <todo_id>

# Complete a todo
todo completed <todo_id>

# Soft delete a todo
todo delete <todo_id>

# Show full history (including deleted)
todo history

# Delete all todos (with confirmation)
todo delete-all

Configuration ⚙️

The application automatically handles database storage:

  • Virtual Environments: Stores data in {venv_path}/todo_data
  • Global Installations: Uses platform-appropriate user data directory

Documentation 📚

For advanced usage and contribution guidelines, see our documentation.


Developed with ❤️ by Mehran Mirzaei
📧 Contact: mehranmirzaeiv@gmail.com

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

rich_todo-0.1.0.tar.gz (8.5 kB view details)

Uploaded Source

Built Distribution

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

rich_todo-0.1.0-py3-none-any.whl (10.6 kB view details)

Uploaded Python 3

File details

Details for the file rich_todo-0.1.0.tar.gz.

File metadata

  • Download URL: rich_todo-0.1.0.tar.gz
  • Upload date:
  • Size: 8.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for rich_todo-0.1.0.tar.gz
Algorithm Hash digest
SHA256 812d060e0aebe9becce70b56285f9fa036144b548df2d906a969de5abed33bb7
MD5 dd26f183de02701bc76c9cbde02a9589
BLAKE2b-256 7419d27329b25f75da12c6d131cb79f675e50ab5518b09f28eeb77e0bb3eccd4

See more details on using hashes here.

File details

Details for the file rich_todo-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: rich_todo-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 10.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for rich_todo-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1244def9310df68f9c890e8835a80f3f933abe15f8fda4cf3fe99f96f4512bf6
MD5 a60b2b1052771c85bf925eced3c4c0a9
BLAKE2b-256 36894ed88ac9a4d70840b8025298a7316551f99e978a551c6f8ea4cad1606c54

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