Tasky

A lightweight, fast, and easy-to-use CLI task manager built with Node.js.

Tasky helps you manage your daily tasks directly from the terminal. Whether you're a developer, student, or anyone who spends time in the command line, Tasky lets you quickly create, update, complete, and organize tasks without leaving your workflow.

✨ Features

• ✅ Add new tasks
• 📋 List all saved tasks
• ✏️ Edit existing tasks
• 🗑️ Delete tasks
• ✔️ Mark tasks as completed
• ↩️ Mark completed tasks as incomplete
• 🚦 Set task priority (Low, Medium, High)
• ⚡ Fast and lightweight
• 💻 Works directly from your terminal

Installation

Install Tasky globally using npm:

npm install -g @umarfarooq57/tasky

Verify the installation:

tasky --version

You can also display the built-in help menu:

tasky --help

Usage

Command Structure

tasky <command> [options]

Add a Task

Creates a new task.

Syntax

tasky add "<task description>"

Example

tasky add "Complete React project"

Add a Task with Priority

Task priority can be one of:

• low
• medium
• high

Syntax

tasky add "<task description>" --priority <level>

or

tasky add "<task description>" -p <level>

Examples

tasky add "Prepare presentation" --priority high

tasky add "Buy groceries" -p low

If no priority is provided, the default priority is:

medium

List All Tasks

Displays every saved task.

Syntax

tasky list

Example

tasky list

Example output:

ID  Status     Task                     Priority
1   [X] Done   Complete React project   High 
2   [ ] Todo   Study Node.js            Medium
3   [ ] Todo   Buy groceries            Low

Edit a Task

Updates the description of an existing task.

Syntax

tasky edit <id> "<new description>"

Example

tasky edit 2 "Study Express.js"

Delete a Task

Removes a task permanently.

Syntax

tasky delete <id>

Example

tasky delete 3

Mark a Task as Completed

Marks a task as done.

Syntax

tasky done <id>

Example

tasky done 1

Mark a Task as Incomplete

Marks a completed task as pending.

Syntax

tasky undone <id>

Example

tasky undone 1

Available Commands

| Command | Description | |---------|-------------| | tasky add "<task>" | Add a new task | | tasky add "<task>" -p high | Add a task with priority | | tasky list | Display all tasks | | tasky edit <id> "<new description>" | Edit a task | | tasky delete <id> | Delete a task | | tasky done <id> | Mark a task as completed | | tasky undone <id> | Mark a task as incomplete | | tasky --help | Show help menu | | tasky --version | Show installed version |

Example Workflow

1. Add some tasks

tasky add "Learn Commander.js"
tasky add "Finish portfolio website" -p high
tasky add "Read Clean Code" -p low

2. View all tasks

tasky list

3. Complete a task

tasky done 2

4. Edit a task

tasky edit 3 "Read Clean Code Chapter 5"

5. Delete a task

tasky delete 1

Priority Levels

Tasky supports three priority levels.

| Priority | Description | |----------|-------------| | low | Less important tasks | | medium | Default priority | | high | Urgent or important tasks |

Requirements

• Node.js 18+
• npm

Contributing

Contributions, issues, and feature requests are welcome.

If you find a bug or have an idea for an improvement, feel free to open an issue or submit a pull request.