task-manager-cli 📋

A simple, lightweight command-line task manager that lets you create and manage task lists stored as local JSON files — no database, no setup, just your terminal.

Installation

npm install -g task-manager-cli

After installing, the taskcli command will be available globally.

Quick Start

# Create a new task list
taskcli create work "My Work Tasks" "Write report" "Send emails"

# Read your task list
taskcli read work

# Add a new task group
taskcli add work "Evening Tasks" "Cook dinner"

# Add an item to an existing task group (by ID)
taskcli "add task" work "Review PR" 1

# Delete a task group by ID
taskcli "delete task" work 2

# Delete the entire file
taskcli delete work

# Spin the donut 🍩
taskcli donut

Commands

create

Creates a new JSON task file with an initial task group.

taskcli create <filename> <title> [task1] [task2] ...

| Argument | Required | Description | |----------|----------|-------------| | filename | ✅ | Name of the file (no extension needed) | | title | ✅ | Title of the first task group | | task... | ❌ | One or more task items to add immediately |

Example:

taskcli create shopping "Grocery List" "Milk" "Eggs" "Bread"

read

Reads and displays all task groups in a file.

taskcli read <filename>

Example:

taskcli read shopping

add

Adds a new task group to an existing file.

taskcli add <filename> <title> [task1] [task2] ...

| Argument | Required | Description | |----------|----------|-------------| | filename | ✅ | Name of the existing file | | title | ✅ | Title for the new task group | | task... | ❌ | One or more task items |

Example:

taskcli add shopping "Household Items" "Soap" "Shampoo"

add task

Adds a single task item into an existing task group, identified by its ID.

taskcli "add task" <filename> <task-item> <id>

| Argument | Required | Description | |-----------|----------|-------------| | filename | ✅ | Name of the existing file | | task-item | ✅ | The task item to add | | id | ✅ | Numeric ID of the task group to add into |

Example:

taskcli "add task" shopping "Butter" 1

Note: Wrap add task in quotes so your shell treats it as a single argument.

delete

Permanently deletes the entire task file.

taskcli delete <filename>

Example:

taskcli delete shopping

delete task

Removes a specific task group from the file by its ID.

taskcli "delete task" <filename> <id>

| Argument | Required | Description | |----------|----------|-------------| | filename | ✅ | Name of the existing file | | id | ✅ | Numeric ID of the task group to delete |

Example:

taskcli "delete task" shopping 2

donut

Renders a spinning ASCII donut animation in your terminal. Because why not. 🍩

taskcli donut

How Data is Stored

Each file is saved as <filename>.json in your current working directory. Here's what the structure looks like:

[
  {
    "id": 1,
    "title": "Grocery List",
    "task": ["Milk", "Eggs", "Bread"]
  },
  {
    "id": 2,
    "title": "Household Items",
    "task": ["Soap", "Shampoo"]
  }
]

License

ISC