📝 Python To-Do List CLI

A command-line task manager with JSON file storage. Add, view, complete, and delete tasks — they persist between sessions. Built with Python 3 — no external dependencies.

✨ Features

• Add tasks with timestamps
• View pending and completed tasks separately
• Mark tasks as completed
• Delete individual tasks
• Clear all completed tasks at once
• JSON file storage (tasks survive program restart)
• Progress tracking (X/Y done)
• Auto ID re-numbering after deletion

🚀 How to Run

# Make sure Python 3.8+ is installed
python --version

# Clone this repository
git clone https://github.com/YOUR-USERNAME/python-todo-list.git
cd python-todo-list

# Run the program
python todo.py

📸 Sample Output

==================================================
  📝 PYTHON TO-DO LIST
  Beginnersly.com — Python Projects
==================================================

📋 Menu: (0 pending)
  1. Add Task
  2. View All Tasks
  3. Complete Task
  4. Delete Task
  5. Clear Completed
  6. Exit

Choice (1-6): 1
📌 Task title: Learn Python basics
✅ Added: "Learn Python basics"

Choice (1-6): 2
───────────────────────────────────────────────────────
  📋 YOUR TO-DO LIST (1 tasks)
───────────────────────────────────────────────────────

  🔴 Pending:
    [1] ⬜ Learn Python basics  (added 2026-06-15 14:30)

  📊 Progress: 0/1 done

📁 Data Storage (tasks.json)

Tasks are saved automatically to tasks.json:

[
  {
    "id": 1,
    "title": "Learn Python basics",
    "done": true,
    "created": "2026-06-15 14:30",
    "completed": "2026-06-15 15:45"
  },
  {
    "id": 2,
    "title": "Build password generator",
    "done": false,
    "created": "2026-06-15 14:31",
    "completed": null
  }
]

🧠 Concepts Used

• JSON file read/write (json.load(), json.dump())
• CRUD operations (Create, Read, Update, Delete)
• Lists and Dictionaries
• datetime module for timestamps
• Functions for code organization
• List comprehensions for filtering
• Error handling (try/except)

📁 Project Structure

python-todo-list/
├── todo.py           # Main source code
├── tasks.json        # Auto-generated data file
├── README.md         # This file
├── .gitignore        # Git ignore rules
└── LICENSE           # MIT License

💡 Ideas to Extend

• Add task priorities (High/Medium/Low)
• Add due dates with overdue alerts
• Add categories/tags
• Add search functionality
• Build web version with Flask
• Export to CSV/TXT

📚 Tutorial

Full tutorial with explanation: Beginnersly.com — To-Do List CLI

📄 License

MIT License — free to use, modify, and share.