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 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.3.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.3-py3-none-any.whl (10.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: rich_todo-0.1.3.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.3.tar.gz
Algorithm Hash digest
SHA256 da840b46286c17a8630ab70680b811ada3d17017823568d14efe6d6e3a1c3daf
MD5 c507c9f576b17d8e936555344f16b2e6
BLAKE2b-256 6cf98288ffc6ac1e7d90f49e79168fd0f129433a16b8284f4d947c803ff6bf08

See more details on using hashes here.

File details

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

File metadata

  • Download URL: rich_todo-0.1.3-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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 a4c0c66b1fbd633e16071a40c9361497f99a391dd718cea4402c78a47455c415
MD5 3a1eef913c41ab50ef6984fc189bcd53
BLAKE2b-256 3fccbfcc3a97b2c3d890efa55f9b29df1c1ea0d7775a864f602e87ee6f625766

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