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.2.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.2-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: x_tasks-0.1.2.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.2.tar.gz
Algorithm Hash digest
SHA256 365256ce34a38d7c8974dae572f7748d4af1a3a45996d8195768e8c7dd074b32
MD5 1e5faa2d87b287945785e4c2a34d660d
BLAKE2b-256 b0542632ae912e44e0aa310719450b484c0145a33d394372273b8113f591fc24

See more details on using hashes here.

File details

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

File metadata

  • Download URL: x_tasks-0.1.2-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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 2bfdffd1925bd53d68e188950c4094e36283659911726071ad22dc4b2134f204
MD5 3b590b97075132e602a4239172ed8ca2
BLAKE2b-256 9847de9feea55769df5c380e9d59ef20c8dbbcb1c33aa1291acc1e24d37cb8c2

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