Skip to main content

CLI task manager

Project description

🚀 Tasks CLI — Minimalist Terminal Task Manager

Project URL: https://github.com/jasurxayitmuradov/Task-Tracker-CLI

A fast and simple command-line task manager built for developers who live in the terminal.

  • Add, update, delete tasks
  • Mark tasks as done or in-progress
  • Filter tasks by status
  • Lightweight JSON storage
  • Fully terminal-based workflow
  • Installable with pip
  • Built for speed and simplicity

📦 Installation

Install from PyPI

pip install x-tasks

Or install locally (development mode)

git clone https://github.com/jasurxayitmuradov/Task-Tracker-CLI.git
cd Task-Tracker-CLI
pip install -e .

🧠 Usage

Add a task

tasks add "Buy milk"

List all tasks

tasks list

List by status

tasks list done
tasks list todo
tasks list in-progress

Update a task

tasks update 1 "Buy milk and eggs"

Delete a task

tasks delete 1

Clear all tasks

tasks clear

Mark task status

tasks mark-in-progress 1
tasks mark-done 1

📁 Storage

Tasks are stored locally in:

~/.tasks/tasks.json

This allows access from anywhere in the terminal.


🛠 Tech Stack

  • Python 3.10+
  • argparse (CLI parsing)
  • JSON (storage)
  • setuptools packaging

🎯 Purpose

This project was built to:

  • Practice real-world Python CLI development
  • Learn packaging and distribution with pip
  • Build production-style project structure
  • Improve backend engineering skills

👨‍💻 Author

Built by a developer who prefers terminal over GUI. Focused on backend engineering, automation, and AI-powered systems.


⭐ Future Improvements

  • Colored terminal output
  • Task priorities
  • Due dates & reminders
  • Config file support
  • Cloud sync (future)

🧾 License

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

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

x_tasks-0.1.1.tar.gz (5.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

x_tasks-0.1.1-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

Details for the file x_tasks-0.1.1.tar.gz.

File metadata

  • Download URL: x_tasks-0.1.1.tar.gz
  • Upload date:
  • Size: 5.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for x_tasks-0.1.1.tar.gz
Algorithm Hash digest
SHA256 76ab9f560531aae8d72096b7b9efc7b163ea72bc7a4238e195d05970675bf3e4
MD5 5ad4b512e84442ea9e4c9251186ef5ea
BLAKE2b-256 6f00de6bbde155e21ef3a9ddeb34ceaaf9576e5a7d8146d22bd2f842a77d25d2

See more details on using hashes here.

File details

Details for the file x_tasks-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: x_tasks-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 6.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for x_tasks-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 784417259720a2ce725754f35dc8e9d4cee9d499ad47da5ee4bbccc01f08c93e
MD5 7e73fca15f258b234a0b0266f516bdea
BLAKE2b-256 872b471710214a4562a87a83ce8ead9977f455c513e98fe450da6ecf3cfbb5b4

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