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.2.tar.gz (8.6 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.2-py3-none-any.whl (10.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: rich_todo-0.1.2.tar.gz
  • Upload date:
  • Size: 8.6 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.2.tar.gz
Algorithm Hash digest
SHA256 b102845b8684adf468ee50c5028d981030c05cb97b7f3af17c55adea1f3e22fa
MD5 88aac812c8b4cf3498badd2b9117dfb8
BLAKE2b-256 3cd4bd9e8c9681dae08c467f69077b020a79561e3cd6d11437edc5a99863c9fb

See more details on using hashes here.

File details

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

File metadata

  • Download URL: rich_todo-0.1.2-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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 8eed7b75cd0a222bbe9eefa506ce134f58c49f196843b0e748a27ae79da7f782
MD5 2f0c8e27ef0d3052cd0e039fed121f09
BLAKE2b-256 8d895f09331e63dcd760bb430587aa7e9a3e5125e578360f55a8cb316c8fa87e

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