{"id":24792735,"url":"https://github.com/misaghmomenib/task-tracker-cli-python","last_synced_at":"2026-05-04T06:34:20.136Z","repository":{"id":263670559,"uuid":"891118425","full_name":"MisaghMomeniB/Task-Tracker-CLI-Python","owner":"MisaghMomeniB","description":"A Command-line Interface (Cli) Task Tracker Built With Python. Efficiently Manage and Organize Tasks, Set Deadlines, and Track Progress—all From the Terminal for a Streamlined Productivity Experience.","archived":false,"fork":false,"pushed_at":"2024-12-24T07:28:06.000Z","size":15,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-29T20:54:51.138Z","etag":null,"topics":["cli","git","python","task-tracker"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MisaghMomeniB.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-19T18:59:01.000Z","updated_at":"2025-01-01T04:40:24.000Z","dependencies_parsed_at":"2024-11-19T20:26:27.799Z","dependency_job_id":"a4d7cbd6-c18f-47df-80c0-c28fa02c23d1","html_url":"https://github.com/MisaghMomeniB/Task-Tracker-CLI-Python","commit_stats":null,"previous_names":["misaghmomenib/task-tracker-cli-python"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MisaghMomeniB%2FTask-Tracker-CLI-Python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MisaghMomeniB%2FTask-Tracker-CLI-Python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MisaghMomeniB%2FTask-Tracker-CLI-Python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MisaghMomeniB%2FTask-Tracker-CLI-Python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MisaghMomeniB","download_url":"https://codeload.github.com/MisaghMomeniB/Task-Tracker-CLI-Python/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245304873,"owners_count":20593626,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","git","python","task-tracker"],"created_at":"2025-01-29T20:54:45.223Z","updated_at":"2026-05-04T06:34:20.130Z","avatar_url":"https://github.com/MisaghMomeniB.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ✅ Task Tracker CLI (Python)\n\nA lightweight and intuitive **command-line task management tool** built in Python for organizing tasks, setting deadlines, and tracking progress—all from your terminal.\n\n---\n\n## 📋 Table of Contents\n\n1. [Overview](#overview)  \n2. [Features](#features)  \n3. [Requirements](#requirements)  \n4. [Installation](#installation)  \n5. [Usage Examples](#usage-examples)  \n6. [Code Structure](#code-structure)  \n7. [Data Persistence](#data-persistence)  \n8. [Enhancements Ideas](#enhancements-ideas)  \n9. [Contributing](#contributing)  \n10. [License](#license)\n\n---\n\n## 💡 Overview\n\nThis simple yet powerful CLI app allows you to manage tasks directly from your command line—creating, updating, deleting, filtering by status (“todo”, “in-progress”, “done”), and persisting list state in JSON format for easy tracking :contentReference[oaicite:1]{index=1}.\n\n---\n\n## ✅ Features\n\n- ➕ **Add tasks** with descriptive titles  \n- 🔁 **Update tasks** to modify titles or change status  \n- 🗑️ **Delete tasks** by ID  \n- ✅ **Mark tasks** as `todo`, `in-progress`, or `done`  \n- 📋 **List tasks** (all, or filter by status)  \n- 🔍 **Search tasks** by keyword  \n- 🔄 **Clear completed tasks**  \n- 💾 **Persistent storage** in `tasks.json`\n\n---\n\n## 🧾 Requirements\n\n- Python **3.7+**  \n- No external libraries (uses `argparse`, `json`, and Python standard library only)\n\n---\n\n## ⚙️ Installation\n\n```bash\ngit clone https://github.com/MisaghMomeniB/Task-Tracker-CLI-Python.git\ncd Task-Tracker-CLI-Python\n````\n\n---\n\n## 🚀 Usage Examples\n\n```bash\n# Add a new task\npython task_tracker.py add \"Write README for project\"\n\n# Update a task's title\npython task_tracker.py update 3 \"Update README with badges\"\n\n# Mark a task in progress or done\npython task_tracker.py mark 3 in-progress\npython task_tracker.py mark 3 done\n\n# List all tasks or by status\npython task_tracker.py list\npython task_tracker.py list todo\n\n# Search tasks by keyword\npython task_tracker.py search README\n\n# Delete a task\npython task_tracker.py delete 3\n\n# Clear all completed tasks\npython task_tracker.py clear done\n```\n\n---\n\n## 📁 Code Structure\n\n```\nTask-Tracker-CLI-Python/\n├── task_tracker.py      # Core CLI app with arg parsing and commands\n├── tasks.json           # Auto-generated data storage file\n└── README.md            # This file\n```\n\n* **task\\_tracker.py**:\n\n  * Parses user commands via `argparse`\n  * Implements task creation, updating, status changes, deletion, searching, listing, and clearing\n  * Handles persistent JSON read/write operations\n\n---\n\n## 💾 Data Persistence\n\nTasks are stored in `tasks.json` with the following fields:\n\n```json\n{\n  \"id\": 1,\n  \"description\": \"Write README for project\",\n  \"status\": \"todo\",\n  \"created_at\": \"2025-06-13T12:34:56\",\n  \"updated_at\": \"2025-06-13T12:34:56\"\n}\n```\n\nThe file is created automatically if it doesn't exist, ensuring seamless first-run experience.\n\n---\n\n## 🌟 Enhancement Ideas\n\n* ⏰ Add **due dates** and **reminders**\n* 🏷️ Add **tags or priority levels**\n* 🌐 Support **batch import/export** via CSV\n* 🚩 Add **CLI flags** for non-interactive modes\n* 🧪 Include **unit tests** (e.g., with `pytest`)\n* 📊 Integrate lightweight **visual reports** (ASCII charts or logs)\n\n---\n\n## 🤝 Contributing\n\nImprovements are welcome! To contribute:\n\n1. Fork this repository\n2. Create a branch (`feature/...`)\n3. Add or update features with clear comments\n4. Submit a Pull Request detailing your changes\n\n---\n\n## 📄 License\n\nLicensed under the **MIT License** — see `LICENSE` for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmisaghmomenib%2Ftask-tracker-cli-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmisaghmomenib%2Ftask-tracker-cli-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmisaghmomenib%2Ftask-tracker-cli-python/lists"}