cli-task-manager

A simple and powerful command-line task manager. Add, list, complete, edit, search, and track tasks right from your terminal — no account, no cloud, just a local JSON file in your home directory.

Installation

npm install -g command-line-tool-task-manager

Requires Node.js >= 18

Once installed, the task command is available globally.

Quick Start

task add "Buy groceries"
task add "Submit report" --priority high
task list
task complete 1
task stats

Commands

task add <title>

Add a new task.

| Option | Alias | Description | Default | |--------|-------|-------------|---------| | --priority <level> | -p | high, medium, or low | medium |

task add "Read documentation"
task add "Fix critical bug" -p high
task add "Clean up comments" -p low

task list / task ls

List all tasks in a formatted table, sorted by status → priority → ID.

| Option | Alias | Description | |--------|-------|-------------| | --filter <status> | -f | completed or pending | | --priority <level> | -p | high, medium, or low |

task list
task ls
task list --filter pending
task list --filter completed
task list --priority high

task complete <id> / task done <id>

Mark a task as completed.

task complete 3
task done 3

task edit <id>

Edit a task's title or priority.

| Option | Alias | Description | |--------|-------|-------------| | --title <title> | -t | New title | | --priority <level> | -p | New priority |

task edit 2 --title "Updated title"
task edit 2 --priority high
task edit 2 -t "New title" -p low

task delete <id> / task rm <id>

Permanently delete a task.

task delete 4
task rm 4

task search <keyword>

Search tasks by keyword (case-insensitive). Matching text is highlighted.

task search bug
task search "meeting notes"

task stats

Show completion statistics with a visual progress bar.

task stats

  Task Statistics
  ─────────────────────────────────
  Total     : 8
  Completed : 5
  Pending   : 3
  Progress  : [██████████████████░░░░░░░░░░░░] 63%

task clear

Remove all completed tasks in one go.

task clear

Data Storage

Tasks are saved to ~/.task-manager/tasks.json. This file is created automatically on first use and persists across all directories and sessions.

To use a custom location (e.g. for per-project task lists):

TASK_MANAGER_DATA_DIR=/path/to/dir task list

Development

git clone https://github.com/ankitw497/Command-Line-Task-Manager.git
cd Command-Line-Task-Manager
npm install

# Run the CLI locally
node src/index.js add "Test task"

# Or link it globally for development
npm link
task add "Test task"

# Run tests
npm test

Project Structure

src/
  index.js    — CLI entry point (commands + argument parsing)
  tasks.js    — Business logic (add, complete, edit, delete, search …)
  storage.js  — JSON persistence (read/write ~/.task-manager/tasks.json)
  display.js  — Table rendering and output formatting
tests/
  tasks.test.js    — Unit tests for task operations (35 tests)
  storage.test.js  — Unit tests for storage layer

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feat/my-feature)
3. Commit your changes
4. Open a Pull Request

Please ensure all tests pass (npm test) before submitting.

License

MIT © Ankit Wahane