TaskFlow CLI

A lightweight command-line task management tool for organizing and tracking your daily tasks with color-coded status and timestamps.

Features

• ✅ Add tasks - Create new tasks with automatic timestamps
• 📋 List tasks - View all tasks with color-coded status (green=completed, red=pending)
• ✓ Mark as done - Mark tasks as completed
• 🗑️ Delete tasks - Remove tasks from your list
• 🔍 Search tasks - Filter tasks by keyword
• 🎨 Color output - Beautiful colored terminal output using colorama
• 💾 Persistent storage - Tasks saved in JSON format

Installation

Requirements

• Python 3.6+

Setup

1. Clone the repository:

git clone https://github.com/yourusername/taskflow-cli.git
cd taskflow-cli

2. Install dependencies:

pip install -r requirements.txt

Usage

Add a task

python modules/main.py add "Buy groceries"

List all tasks

python modules/main.py list

Mark a task as completed

python modules/main.py done 1

Delete a task

python modules/main.py delete 1

Search tasks

python modules/main.py search "Python"

Get help

python modules/main.py help

Project Structure

taskflow-cli/
├── modules/
│   ├── main.py          # Entry point and CLI handler
│   ├── manager.py       # Task management logic
│   ├── storage.py       # File I/O operations
│   └── __init__.py      # Package initialization
├── data/
│   └── tasks.json       # Task storage (auto-created)
├── requirements.txt     # Python dependencies
└── README.md            # This file

Data Format

Tasks are stored in data/tasks.json with the following structure:

[
  {
    "id": 1,
    "description": "Buy groceries",
    "completed": false,
    "created_at": "2025-10-20 19:30"
  }
]

Dependencies

• colorama - For colored terminal output

License

MIT

Author

Created with ❤️ for task management enthusiasts