✅ Stilltodo — Task Management for Developers

A simple CLI tool that lets you handle your pending tasks like a real programmer, directly from the terminal. You don’t have to leave it anymore — your endless todo list stays in your work environment so you can keep working, day after day, until burnout feels inevitable.

🧠 What is this?

Stilltodo is a lightweight command-line application built with Node.js for developers who spend most of their day in the terminal and want to manage tasks without leaving it.

🌍 Installation

Install globally from npm

npm install -g stilltodo

Then use it anywhere with:

todo --help

▶️ Usage

The CLI is exposed through the todo command.

Add a new task (default command)

todo "Refactor legacy service"

By default, tasks are set to be due today. You can specify different due dates:

todo "Review pull requests" --week    # Due this week
todo "Plan Q2 roadmap" -m             # Due this month
todo "Learn Rust" --year              # Due this year
todo "Read that book" -s              # Someday

Get all tasks

todo all

Tasks are automatically sorted by due date (today → week → month → year → someday). Overdue tasks are displayed in red.

Complete a task by its number

todo complete 3

Remove completed tasks

todo clear

👉 You can see the full list of commands and options at any time by running:

todo --help

📋 Available Commands

todo <description>      add a new task (default)
todo all                get all tasks
todo complete <number>  complete task n° <number>
todo clear              remove completed tasks

Due Date Options (for add command)

-t, --today     Due today (default)
-w, --week      Due this week
-m, --month     Due this month
-y, --year      Due this year
-s, --someday   Someday (no specific deadline)

Clear Command Options

-a, --all       Remove all tasks (not just completed ones)

✨ Features

• 🖥️ Manage tasks directly from the terminal
• ⚡ Default command for quickly adding new tasks
• � Due date management (today, week, month, year, someday)
• 🔴 Overdue tasks highlighted in red
• 📊 Automatic sorting by due date priority
• 🔢 Simple numeric task completion
• 📂 File-based persistence
• 🧪 Unit tests with Jest
• 📦 Modern ES Modules setup

🛠️ Tech Stack & Key Packages

Runtime

• Node.js (ES Modules enabled)

Main Packages

• 📌 yargs — CLI command parsing and argument handling
• 🧪 jest — Unit testing framework

Native Modules

• 📁 fs — File system access for task persistence

Development

🔗 Install the CLI locally

To make the todo command available globally during development:

npm link

🧪 Testing

This project includes basic unit tests using Jest, configured to work with Node.js ES Modules.

Run tests with:

npm test

🧩 Pending Work / Roadmap

• 🗄️ Add database integration (replace file-based storage)
• 🧪 Complete and expand the test suite

🎯 Intended Audience

This project is intended for developers, especially those who live in the terminal and prefer simple tools over heavy productivity systems.

👤 Author

Kevin Parra
Senior Frontend Engineer | JavaScript • React • Node.js

🔗 LinkedIn: https://www.linkedin.com/in/evinracher/