command-line-tool-task-manager 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ankit Wahane
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,209 @@
+# 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.
+
+[![CI](https://github.com/ankitw497/Command-Line-Task-Manager/actions/workflows/ci.yml/badge.svg)](https://github.com/ankitw497/Command-Line-Task-Manager/actions/workflows/ci.yml)
+[![npm version](https://badge.fury.io/js/command-line-tool-task-manager.svg)](https://www.npmjs.com/package/command-line-tool-task-manager)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+---
+
+## Installation
+
+```bash
+npm install -g command-line-tool-task-manager
+```
+
+> Requires Node.js >= 18
+
+Once installed, the `task` command is available globally.
+
+---
+
+## Quick Start
+
+```bash
+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` |
+
+```bash
+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` |
+
+```bash
+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.
+
+```bash
+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 |
+
+```bash
+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.
+
+```bash
+task delete 4
+task rm 4
+```
+
+---
+
+### `task search <keyword>`
+
+Search tasks by keyword (case-insensitive). Matching text is highlighted.
+
+```bash
+task search bug
+task search "meeting notes"
+```
+
+---
+
+### `task stats`
+
+Show completion statistics with a visual progress bar.
+
+```bash
+task stats
+```
+
+```
+  Task Statistics
+  ─────────────────────────────────
+  Total     : 8
+  Completed : 5
+  Pending   : 3
+  Progress  : [██████████████████░░░░░░░░░░░░] 63%
+```
+
+---
+
+### `task clear`
+
+Remove all completed tasks in one go.
+
+```bash
+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):
+
+```bash
+TASK_MANAGER_DATA_DIR=/path/to/dir task list
+```
+
+---
+
+## Development
+
+```bash
+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](https://github.com/ankitwahane)

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "command-line-tool-task-manager",
+  "version": "1.0.0",
+  "description": "A simple and powerful command-line task manager — add, list, complete, edit, search and track tasks right from your terminal.",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "task": "./src/index.js"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "test": "node --test tests/tasks.test.js tests/storage.test.js"
+  },
+  "keywords": [
+    "cli",
+    "task",
+    "manager",
+    "todo",
+    "productivity",
+    "command-line",
+    "terminal"
+  ],
+  "author": "Ankit Wahane",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ankitw497/Command-Line-Task-Manager.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ankitw497/Command-Line-Task-Manager/issues"
+  },
+  "homepage": "https://github.com/ankitw497/Command-Line-Task-Manager#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "src/",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "cli-table3": "^0.6.3",
+    "commander": "^12.0.0"
+  }
+}

package/src/display.js

@@ -0,0 +1,91 @@
+import chalk from 'chalk';
+import Table from 'cli-table3';
+
+export const PRIORITY_ORDER = { high: 0, medium: 1, low: 2 };
+
+export const PRIORITY_LABEL = {
+  high: chalk.red.bold('HIGH'),
+  medium: chalk.yellow.bold('MED'),
+  low: chalk.green.bold('LOW'),
+};
+
+export const PRIORITY_DOT = {
+  high: chalk.red('●'),
+  medium: chalk.yellow('●'),
+  low: chalk.green('●'),
+};
+
+export function formatDate(iso) {
+  if (!iso) return chalk.gray('—');
+  const d = new Date(iso);
+  const pad = (n) => String(n).padStart(2, '0');
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
+}
+
+export function formatTitle(task) {
+  return task.completed ? chalk.gray.strikethrough(task.title) : task.title;
+}
+
+export function statusIcon(task) {
+  return task.completed ? chalk.green('✔') : chalk.gray('○');
+}
+
+export function highlightMatch(text, keyword) {
+  const escaped = keyword.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  return text.replace(new RegExp(escaped, 'gi'), (m) => chalk.cyan.bold(m));
+}
+
+/**
+ * Build a formatted table for the given tasks.
+ * @param {object[]} tasks
+ * @param {(task: object) => string} [titleFn] Optional override for title cell rendering
+ */
+export function buildTable(tasks, titleFn = null) {
+  const table = new Table({
+    head: [
+      chalk.cyan.bold('ID'),
+      chalk.cyan.bold(''),
+      chalk.cyan.bold('Title'),
+      chalk.cyan.bold('Priority'),
+      chalk.cyan.bold('Created'),
+      chalk.cyan.bold('Completed'),
+    ],
+    colWidths: [5, 3, 38, 10, 20, 20],
+    style: { head: [], border: ['gray'] },
+    wordWrap: true,
+  });
+
+  for (const task of tasks) {
+    const title = titleFn ? titleFn(task) : formatTitle(task);
+    table.push([
+      chalk.dim(String(task.id)),
+      statusIcon(task),
+      title,
+      `${PRIORITY_DOT[task.priority]} ${PRIORITY_LABEL[task.priority]}`,
+      chalk.dim(formatDate(task.createdAt)),
+      chalk.dim(formatDate(task.completedAt)),
+    ]);
+  }
+
+  return table;
+}
+
+export function printStats(tasks) {
+  const total = tasks.length;
+  const completed = tasks.filter((t) => t.completed).length;
+  const pending = total - completed;
+  const pct = total === 0 ? 0 : Math.round((completed / total) * 100);
+
+  const BAR_WIDTH = 30;
+  const filled = Math.round((pct / 100) * BAR_WIDTH);
+  const bar = chalk.green('█'.repeat(filled)) + chalk.gray('░'.repeat(BAR_WIDTH - filled));
+
+  console.log('');
+  console.log(chalk.bold('  Task Statistics'));
+  console.log(chalk.gray('  ─────────────────────────────────'));
+  console.log(`  Total     : ${chalk.bold(total)}`);
+  console.log(`  Completed : ${chalk.green.bold(completed)}`);
+  console.log(`  Pending   : ${chalk.yellow.bold(pending)}`);
+  console.log(`  Progress  : [${bar}] ${chalk.bold(pct + '%')}`);
+  console.log('');
+}

package/src/index.js

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import chalk from 'chalk';
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+import {
+  addTask,
+  listTasks,
+  completeTask,
+  deleteTask,
+  editTask,
+  searchTasks,
+  clearCompleted,
+  getAllTasks,
+  VALID_PRIORITIES,
+} from './tasks.js';
+import { buildTable, printStats, highlightMatch } from './display.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
+
+function handleError(err) {
+  console.error(chalk.red('Error: ') + err.message);
+  process.exit(1);
+}
+
+program
+  .name('task')
+  .description('A simple and powerful command-line task manager')
+  .version(pkg.version, '-V, --version', 'output the current version');
+
+// ── add ──────────────────────────────────────────────────────────────────────
+
+program
+  .command('add <title>')
+  .description('Add a new task')
+  .option('-p, --priority <level>', `Priority: ${VALID_PRIORITIES.join(' | ')}`, 'medium')
+  .action((title, opts) => {
+    try {
+      const task = addTask(title, opts.priority.toLowerCase());
+      console.log(chalk.green(`✔ Added task #${task.id}:`) + ' ' + task.title);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+
+// ── list ─────────────────────────────────────────────────────────────────────
+
+program
+  .command('list')
+  .alias('ls')
+  .description('List all tasks')
+  .option('-f, --filter <status>', 'Filter: completed | pending')
+  .option('-p, --priority <level>', `Filter by priority: ${VALID_PRIORITIES.join(' | ')}`)
+  .action((opts) => {
+    try {
+      const tasks = listTasks({ filter: opts.filter, priority: opts.priority });
+      if (tasks.length === 0) {
+        console.log(chalk.yellow('No tasks found.'));
+        return;
+      }
+      console.log(buildTable(tasks).toString());
+      console.log(chalk.dim(`  ${tasks.length} task(s)`));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+
+// ── complete ──────────────────────────────────────────────────────────────────
+
+program
+  .command('complete <id>')
+  .alias('done')
+  .description('Mark a task as completed')
+  .action((id) => {
+    try {
+      const task = completeTask(parseInt(id, 10));
+      console.log(chalk.green(`✔ Completed task #${task.id}:`) + ' ' + task.title);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+
+// ── delete ────────────────────────────────────────────────────────────────────
+
+program
+  .command('delete <id>')
+  .alias('rm')
+  .description('Delete a task permanently')
+  .action((id) => {
+    try {
+      const task = deleteTask(parseInt(id, 10));
+      console.log(chalk.red(`✖ Deleted task #${task.id}:`) + ' ' + task.title);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+
+// ── edit ──────────────────────────────────────────────────────────────────────
+
+program
+  .command('edit <id>')
+  .description('Edit a task title or priority')
+  .option('-t, --title <title>', 'New title')
+  .option('-p, --priority <level>', `New priority: ${VALID_PRIORITIES.join(' | ')}`)
+  .action((id, opts) => {
+    try {
+      const task = editTask(parseInt(id, 10), { title: opts.title, priority: opts.priority });
+      console.log(chalk.blue(`✎ Updated task #${task.id}:`) + ' ' + task.title);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+
+// ── search ────────────────────────────────────────────────────────────────────
+
+program
+  .command('search <keyword>')
+  .description('Search tasks by keyword')
+  .action((keyword) => {
+    try {
+      const tasks = searchTasks(keyword);
+      if (tasks.length === 0) {
+        console.log(chalk.yellow(`No tasks match "${keyword}".`));
+        return;
+      }
+      const table = buildTable(tasks, (task) => {
+        const highlighted = highlightMatch(task.title, keyword);
+        return task.completed ? chalk.gray.strikethrough(highlighted) : highlighted;
+      });
+      console.log(table.toString());
+      console.log(chalk.dim(`  ${tasks.length} match(es) for "${chalk.cyan(keyword)}"`));
+    } catch (err) {
+      handleError(err);
+    }
+  });
+
+// ── stats ─────────────────────────────────────────────────────────────────────
+
+program
+  .command('stats')
+  .description('Show task statistics and progress')
+  .action(() => {
+    try {
+      printStats(getAllTasks());
+    } catch (err) {
+      handleError(err);
+    }
+  });
+
+// ── clear ─────────────────────────────────────────────────────────────────────
+
+program
+  .command('clear')
+  .description('Remove all completed tasks')
+  .action(() => {
+    try {
+      const count = clearCompleted();
+      if (count === 0) {
+        console.log(chalk.yellow('No completed tasks to clear.'));
+      } else {
+        console.log(chalk.green(`✔ Cleared ${count} completed task(s).`));
+      }
+    } catch (err) {
+      handleError(err);
+    }
+  });
+
+program.parse(process.argv);

package/src/storage.js

@@ -0,0 +1,28 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+// Read dynamically so tests can override via TASK_MANAGER_DATA_DIR
+function getDataDir() {
+  return process.env.TASK_MANAGER_DATA_DIR || join(homedir(), '.task-manager');
+}
+
+function getTasksFile() {
+  return join(getDataDir(), 'tasks.json');
+}
+
+export function loadTasks() {
+  const file = getTasksFile();
+  if (!existsSync(file)) return [];
+  try {
+    return JSON.parse(readFileSync(file, 'utf-8'));
+  } catch {
+    return [];
+  }
+}
+
+export function saveTasks(tasks) {
+  const dir = getDataDir();
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(getTasksFile(), JSON.stringify(tasks, null, 2), 'utf-8');
+}

package/src/tasks.js

@@ -0,0 +1,99 @@
+import { loadTasks, saveTasks } from './storage.js';
+import { PRIORITY_ORDER } from './display.js';
+
+export const VALID_PRIORITIES = ['high', 'medium', 'low'];
+
+function nextId(tasks) {
+  return tasks.length === 0 ? 1 : Math.max(...tasks.map((t) => t.id)) + 1;
+}
+
+export function sortTasks(tasks) {
+  return [...tasks].sort((a, b) => {
+    if (a.completed !== b.completed) return a.completed ? 1 : -1;
+    const pd = PRIORITY_ORDER[a.priority] - PRIORITY_ORDER[b.priority];
+    if (pd !== 0) return pd;
+    return a.id - b.id;
+  });
+}
+
+export function addTask(title, priority = 'medium') {
+  if (!VALID_PRIORITIES.includes(priority)) {
+    throw new Error(`Invalid priority "${priority}". Use: ${VALID_PRIORITIES.join(', ')}`);
+  }
+  const trimmed = title.trim();
+  if (!trimmed) throw new Error('Task title cannot be empty.');
+
+  const tasks = loadTasks();
+  const task = {
+    id: nextId(tasks),
+    title: trimmed,
+    priority,
+    completed: false,
+    createdAt: new Date().toISOString(),
+    completedAt: null,
+  };
+  tasks.push(task);
+  saveTasks(tasks);
+  return task;
+}
+
+export function listTasks({ filter, priority } = {}) {
+  let tasks = loadTasks();
+  if (filter === 'completed') tasks = tasks.filter((t) => t.completed);
+  else if (filter === 'pending') tasks = tasks.filter((t) => !t.completed);
+  if (priority) tasks = tasks.filter((t) => t.priority === priority);
+  return sortTasks(tasks);
+}
+
+export function completeTask(id) {
+  const tasks = loadTasks();
+  const task = tasks.find((t) => t.id === id);
+  if (!task) throw new Error(`Task #${id} not found.`);
+  if (task.completed) throw new Error(`Task #${id} is already completed.`);
+  task.completed = true;
+  task.completedAt = new Date().toISOString();
+  saveTasks(tasks);
+  return task;
+}
+
+export function deleteTask(id) {
+  const tasks = loadTasks();
+  const idx = tasks.findIndex((t) => t.id === id);
+  if (idx === -1) throw new Error(`Task #${id} not found.`);
+  const [task] = tasks.splice(idx, 1);
+  saveTasks(tasks);
+  return task;
+}
+
+export function editTask(id, { title, priority } = {}) {
+  if (!title && !priority) {
+    throw new Error('Provide at least --title or --priority to edit.');
+  }
+  if (priority && !VALID_PRIORITIES.includes(priority)) {
+    throw new Error(`Invalid priority "${priority}". Use: ${VALID_PRIORITIES.join(', ')}`);
+  }
+  const tasks = loadTasks();
+  const task = tasks.find((t) => t.id === id);
+  if (!task) throw new Error(`Task #${id} not found.`);
+  if (title) task.title = title.trim();
+  if (priority) task.priority = priority;
+  saveTasks(tasks);
+  return task;
+}
+
+export function searchTasks(keyword) {
+  const kw = keyword.toLowerCase();
+  return sortTasks(loadTasks().filter((t) => t.title.toLowerCase().includes(kw)));
+}
+
+export function clearCompleted() {
+  const tasks = loadTasks();
+  const remaining = tasks.filter((t) => !t.completed);
+  const count = tasks.length - remaining.length;
+  saveTasks(remaining);
+  return count;
+}
+
+export function getAllTasks() {
+  return loadTasks();
+}