Skip to main content

A CLI tool for managing todos directly from the terminal

Project description

Todo CLI 🚀

Python 3.6+ PyPI Version GitHub 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.1.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.1-py3-none-any.whl (10.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: rich_todo-0.1.1.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.1.tar.gz
Algorithm Hash digest
SHA256 7c1babfdc0c539005c447024b62b6959be4c1950edbae78bda81c7996fe3d418
MD5 9f715db59cc5a9cd53ed5b5a145019ea
BLAKE2b-256 02ee7225ef807934adf4f010e9235e379fa7f18d7e900e72e5509f8abd50f432

See more details on using hashes here.

File details

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

File metadata

  • Download URL: rich_todo-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 10.7 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 dd1c161783cad02dafc487bdb8a86bc044b3f4b6604e9f1f92a86f52de6fc56e
MD5 5424768ad8d98ac0979b6cdc23bb932b
BLAKE2b-256 1fdb4d21bd6121d8d6c18647f73b487067ffe10304c5aee5b0d972a8fb93aec8

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