Skip to content

A simple command-line task manager written in Python. Add, list, update, and delete tasks stored locally in a JSON file.

License

Notifications You must be signed in to change notification settings

rumindvisuals/task-tracker-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 

Repository files navigation

🗂️ Task Tracker CLI

A simple command-line based task manager. This script allows you to create, list, update, and delete tasks, storing them locally in a tasks.json file.

📦 Features

  • 📌 Add new tasks
  • 📄 Update title, description, or status
  • ❌ Delete tasks with optional confirmation
  • 🔍 List tasks by status or show all
  • 💾 Local storage using JSON format

🚀 Usage

📥 Requirements

  • Python 3.7 or higher

📚 Installation

git clone https://github.com/rumindvisuals/task-tracker-cli.git
cd task-tracker-cli/src
python3 task_cli.py --help

🧑‍💻 Available Commands

Add Task

python3 task_cli.py add --title "Buy milk" --description "Go to the store before 5 PM"

List Tasks

python3 task_cli.py list
# or filter by status
python3 task_cli.py list todo
python3 task_cli.py list in-progress
python3 task_cli.py list done

Update Task

python3 task_cli.py update 0 --title "Buy bread" --status done

Delete Task

python3 task_cli.py delete 0
# delete without confirmation
python3 task_cli.py delete 0 --force

🧠 Task Structure

Each task is saved in the tasks.json file with the following structure:

{
  "id": 0,
  "title": "Buy milk",
  "description": "Go to the store before 5 PM",
  "created_at": "2025-07-24 13:40:02",
  "updated_at": "2025-07-24 13:40:02",
  "status": "todo"
}

✅ Available Status Values

  • todo – Task pending
  • in-progress – Task in progress
  • done – Task completed

🛠 Development

This project is intended for educational and personal use. It can be easily extended to include features like due dates, priorities, tags, export options, and more.

📄 License

MIT License. Free to use, modify, and distribute.

About

A simple command-line task manager written in Python. Add, list, update, and delete tasks stored locally in a JSON file.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages