Skip to main content

CLI task manager

Project description

🚀 Tasks CLI — Minimalist Terminal Task Manager

A fast and simple command-line task manager built for developers who live in the terminal. Manage your daily tasks directly from your shell with clean commands and zero distractions.


✨ Features

  • 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 (after publishing)

pip install tasks-cli

Or install locally (development mode)

git clone https://github.com/yourusername/tasks-cli.git
cd tasks-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

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.0.tar.gz (4.2 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.0-py3-none-any.whl (5.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: x_tasks-0.1.0.tar.gz
  • Upload date:
  • Size: 4.2 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.0.tar.gz
Algorithm Hash digest
SHA256 a2376ed83fdc517ecc878737d0c1a1cbf6a82fe378256f2155b8601a7529aa2f
MD5 4ce55a3575e6a0dc9e5152d729f0d8e2
BLAKE2b-256 f65c6b4bc2df3ba379815f046714c724d90e60f30392f4d5e05b60242e507028

See more details on using hashes here.

File details

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

File metadata

  • Download URL: x_tasks-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 5.9 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 144551139a28bce65972a7d06e2bb6e932916b9d4b4cbe6485e6a8acf261f9ac
MD5 4a09c595377028ac580a40f8e0fa56bc
BLAKE2b-256 80c6359fdf5d3f1af0a15b83cfa7b6041827d4b03d987bafa5803587e65df5ae

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